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Introduction 


CDOS is the Cromemco Disk Operating System. 


The primary use of CDOS is to perform Input/Output 
with floppy diskettes (disks). It is designed to 
allow users of Cromemco microcomputer systems to 
create and manipulate both random and sequential 
disk files using symbolic names. 


CDOSGEN is the Cromemco Disk Operating System GEN- 
erator. 


It is designed to allow users of CDOS to tailor the 
Operating System to the needs and hardware 
configuration at hand. It allows standard or 
custom Functions to be programmed into the Function 
Keys of the Cromemco 3191 Terminal. 

Most Cromemco software packages are provided with a 
32K version of CDOS which may be directly booted up 
as shipped. CDOSGEN is also provided with most 
Cromemco software packages. 


This is designed as both a reference and an 
instructional manual. Section One describes the 
Structure of CDOS, its memory allocation, disk 
layout, and file structure. Section Two covers 
CDOSGEN including the various parameters necessary 
to use this program. CDOS operation, start up, and 
command structure are described in Section Three. 
Intrinsic commands and Utility programs are covered 
in Section Four. Section Five is the CDOS 
Programmer's Manual. This section is designed for 
the advanced user who wants to gain an in depth 
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understanding of CDOS and its file structure. 
Section Six contains a list and explanation of the 
CDOS error messages. Finally, Section Seven 
contains a glossary of terms and symbols as they 
are used throughout this manual. 
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System Structure 


Memory Allocation 


Under CDOS, memory is divided into two major parts. 
(Please refer to the cDbDOS Memory Use Map while 
reading this section.) 


The first part is that area which is reserved for 
CDOS itself. CDOS occupies memory from location 9 
through 18@H (Low Memory) as well as approximately 
8K of memory above the user area (High Memory). 


The second part is the User Area. The User Area 
occupies memory from 18@H up to the bottom of CDOS. 
The size of the user area is determined when 
CDOSGEN is run and is limited by the amount of 
memory in the system. 


The system is described by the total number of 
bytes it occupies. Most Cromemco software packages 
are supplied with a 32K system. 


CDOS is loaded from the System Area of the disk 
into memory by a bootstrap routine. The CONPROC 
portion of CDOS is the last portion to be loaded 
and is read from the File Area of the disk. 


By special use of Low Memory (@-190H), all user 
Programs call CDOS through a standard sequence 
which is transparent to the size of CDOS. 


Referring to the CDOS Memory Use Map, we see that 
Random Access Memory (RAM) is divided into the 
following areas: 


Ios ; 
The Input/Output System contains the basic 
input/output functions for the console, printer, 
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punch, and reader as well as the disk I/O drivers. 


~DOS 

The Disk Operating System is responsible for 
managing, creating, opening, reading, and writing 
disk files. It also is in charge of calling user 
programs and editing console input. 


CONPROC 
The CONsSole PROCesSSor acts as the normal user 
interface. It calls a user program based on a 


simple command line typed on the console and passes 
parameters from the command to the program. It has 
some internal functions called intrinsic. commands 
(see section 4.1). 


The external functions are the utility (see section 
4.2) and user COMmand files which are located on 
the disk. These files can be identified by the COM 
file name extension. They are executed by typing 
the file name without the file name extension (COM 
is assumed) in response to the CDOS prompt. 


User Area 

This is where programs are actually run. The User 
Area begins at 1@@H (256 decimal) and extends to 
the system stack below the Console Processor. All 
programs which are not intrinsic to CDOS are run in 
this area. Intrinsic programs do not run in this 
area and therefore do not alter it. 


Low Memory 
Memory below the User Area is reserved for CDOS for 
the following special purposes: 


OH System warm start vector 

5H System call vector for user requests 
8-4 9H Reserved for interrupt vectors 
40-5BH Reserved for system 

5C-7FH Standard user file control blocks 
80-FFH Standard user I/O buffer 


The reader is referred to section 5, CDOS 
Programmer's Guide, for a more detailed discussion 
of the use of Low Memory. 
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1.2 


MEMORY DISK 
(HIGH) (END) 
abe owe CONPROC 
FROM TOP 
USER FILES 
8in. DISK: 241 K-BYTES eon 
5in. DISK: 81 K-BYTES 
USER AREA 
2 k-eyTes { 
10H 
RESERVED (CDOS) ST NOME AREA 
LOW MEMORY 
(LOW) OH 


CDOS MEMORY USE MAP CDOS DISK USE MAP 


Floppy Diskettes 


A floppy diskette (or disk) is a flat, round 
magnetic storage medium. It is protected by a 
Square envelope which exposes only a small portion 
of the surface of the disk in addition to the hole 


in the center. When used in conjunction with a 


disk drive and disk controller, the disk becomes a 
data file storage device. Data can be added to the 
data already on the disk or data on the disk can be 
changed or deleted. 
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Disk Organization 


Each disk used under CDOS is divided into two 
general areas. 


The first area is the System Area. It is 
accessible to the user only through the WRTSYS 
utility program. The contents of this area is not 
listed by the DIRectory intrinsic command. The 
system files occupy the outer three (for 5 inch 
disks) or two (for 8 inch disks) tracks. of the 
disk. As can be seen from the CDOS Disk Use Map, 
starting from track zero, sector one, the system 
files are the Bootstrap Loader and CDOS Resident 
Image. 


The second area is the File Area. This is the 
section where user files (programs, data, etc.) 
and the disk directory are stored. The size of the 
user file area (exclusive of the File Directory) is 
241 kilobytes for large (8 inch) and 81 kilobytes 
for small (5 inch) disks. 


NOTE: The use of the two areas described above is 
not related. Even if the DIRectory command 
indicates a full disk, a copy of CDOS may still be 
written to the System Area using WRTSYS. The 
DiIRectory Intrinsic only indicates the User File 
portion of the File Area which is occupied on the 
disk. This has no bearing on the System Area. 


Write Protecting Diskettes 


8" Diskettes 

The large 8" diskettes are write-protected by a 
notch on the bottom right side (as you face the 
label) of the plastic disk cover. To write on the 
disk, cover the notch with a de-write-protect 


sticker or a piece of masking tape. 


5.25" Diskettes 

The small 5.25" diskettes are write-protected by 
the presence of the silver write-protect sticker 
covering the notch. Remove this sticker to allow 
you to write on the disk. 


Important Distinction 
It is important to note that large disks are write- 


protected by removing the silver sticker, and small 
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disks are write-protected by placing the silver 


Sticker over the notch. 


1.2.3 Precautions Concerning Diskettes 


The following precautions are suggested. They are 
designed to minimize the chance of damage to files 
stored on floppy diskettes. 


a 

a 
a 
2) 
3) 

2 

eae 

as 

Le 


Whenever changing diskettes, log in the newly. 
inserted disk by initiating a warm start. 
This is done by sending a CTRL-C character to 
the computer (refer to section.3.1.4) This 
procedure is not necessary immediately after 
booting up CDOS or Resetting the computer. 


Execute the STATus Utility program 
occaSionally in order to verify the directory 
(refer to section 4.2.4). 


Diskettes are magnetic media. The following 


care and attention should be given to floppy 
disks: 


a) Keep them away from all sources of 
magnetic fields such as power 
transformers and solenoids. 


b) Store them in their dust covers and 
NEVER lay the bare disk down on a dusty 
surface. 


c) Keep them out of direct sunlight as the 
black plastic heats up rapidly. Normal 
Storage temperature is 58 to 125 degrees 
Fahrenheit (18 to 52 degrees Celsius). 


d) Do not write on the plastic disk. jacket 
with anything but a soft felt tip pen. 


e) Do not touch or try to clean the disk 


surface. Abrasions may cause loss of 
data. 


£) Never bend or fold the disk. 


g) It is suggested that the disk not be 
loaded (i.e., inserted in the drive (with 
the door closed)) while powering up or 
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down. Under these conditions random data 
may be written to the disk. In case of 
power failure it is wise to check the 
disk for errors following the return of 
power. 


4) As an additional safety precaution, maintain 
adequate archives of back up disks. Data may 
occasionally be lost and the additional cost 
of back up disks is well worth the valuable 
programs, data, and time which may be saved. 


Data Files 


Data is information. Some examples of data are: a 
list of names and addresses, a Fortran program, the 
text of a letter or a manual, etc. 


A file is a place and method for storing many 
individual items of information. Some examples of 
files are: a telephone or address book, a filing 
cabinet, the paper on which a grocery list is 
written, etc. 


A computer data file (or simply file) is described 
by: 


1. the storage medium (paper tape, floppy 
disk, etc.), 


25 the method of accessing the data 
(sequential or random), and 


3. the code by which the data is translated 
for storage (ASCII or internal machine 
representation). 


When a file is created it is given an identifier so 
that it may be referenced at a later time. This 
identifier is the file name and optionally the file 
name extension. 


Files may be stored in the same format as data is 
stored inside the computer. This is referred to as 
Internal Machine Representation. Files also may be 
coded (or formatted) according to the American 
Standard Code for Information Interchange (ASCII). 
An ASCII file contains only numbers from the ASCII 
table. On output, each of these numbers is 


14 


LETTS. 


an 7% 


CROMEMCO DISK OPERATING SYSTEM USER'S MANUAL 
1 - System Structure 


translated into the character it represents. An 
ASCII file may be TYPEd while a file stored in 
internal machine representation must be DUMPed. 


Files may be read from or written to a number of 
devices. The standard devices available under CDOS 
are: 


Device Data Transfer 

Console Input & Output 
Printer Output 

Reader Input 

Punch Output 

Floppy Disk Input & Output 


As normally delivered, only the console, printer, 
and disk are active. The reader and punch drivers 
are implemented using the same port assignments as 
the console. These must typically be changed for a 
particular user's application. 


The primary use of CDOS is to perform I/O with the 
disk. Any combination of up to four large (8 inch) 
and small (5 inch) floppy disk drives May be 
connected to a Cromemco 4FDC Controller. Unlike 
Some large computer systems, all disk files under 


CDOS may be accessed in either random or sequential 
order. 


Devices are pre-defined by CDOS, but disk files are 
dynamically created, extended or deleted as 
required. As will be described in the next 
section, symbolic names are often used to describe 
files. 


Device Names 


The following symbolic names may be used when 


referring to devices accessible by CDOS. 


Format: xxx: [#] 


where: 


XXX represents a three character name and # is an 
optional number (@ thru 7) from the following 
table: 
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143%261 


Device Name Number Range 

Console CON: Beeeol 

Card Reader RDR: © B.e03 

Paper-tape Punch PUN: G..3 

Line Printer LST: @,1 (either term 
PRT: ®,1 may be used) 

Dummy Device ' DUM: ---(bit bucket/EOF) 


Disk File References 


The following convention is followed. throughout 
this manual: 


the term: 
file-ref or file reference 
is used to describe: 


a) a single file reference (see section 1.3.2.1) 
including a file name and optionally a disk 
drive specifier and file name extension, 


or 


b) an ambiguous file reference if it is 
specifically stated that the file-ref may 
include the * and ? replacement characters 
(see section 1.3.2.2). 


Single File Reference 


A Single File Reference is a unique reference to a 
unique file stored on a floppy disk and accessible 
by CDOS. By default or by specification this type 
of reference addresses a particular file (file name 
plus an optional file name extension) on a 
particular disk drive. 


Formats: {(X:] filename[.ext] 
where: 
xX is an optional disk drive specifier 
indicating the location of the file 


being referenced. Legal values are 
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A, B, C, and D. 


filename is a file name composed of up to 
eight printable ASCII characters 
except as specified in Note l. 


ext is an optional 1 to 3 character 
extension to the file name. See 
Notes 1 and 3. 


Notes: 


1) A file name or extension may include any 
printable ASCII character except the following: 


$*#? =/, , 3: “space" 


2) Although lower case characters are accepted 
without modification by some user programs, all 
system functions convert lower case input of file 
names to upper case. 


3) There are several standard types of filename 
extensions expected by some Cromemco system 
Programs. These are listed below: 


BAK Editor back-up file 

BAS BASIC LISTed source file (optional) 
CMD Batch command file 

COB COBOL source file 

COM Executable command program 

FOR FORTRAN source file 

HEX Intel Hex format object file 

LIB Source Library 

LIS BASIC LISTed source file (optional) 
PRN Printer or listing file 

REL Relocatable module (object file) 
SAV BASIC SAVEd source file (optional) 
SYS System image file 

TXT Text Formatter input file (optional) 
Z8® Assembler source file 


4) When an executable COMmand file is referred to 
without the optional .disk drive specifier, the 
system will search the current drive for the file. 
If this search fails (and the current drive is not 
the A drive) the A drive is then searched for the 
file. This procedure is followed only for COM 
files. 
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Examples: 


A:PROGRAM1.FOR refers to a (FORTRAN source) file on 


the disk in drive A named PROGRAM] with a file name 
extension of FOR. 


C:BASIC.COM refers to an (executable COMmand) file 
on the disk in drive C. The file name is BASIC and 
the file name extension is COM. 


PROG.REL refers to a (relocatable object) file on 
the disk in the current drive named PROG with a 
file name extension of REL. 


1.3.2.2 Ambiguous File Reference 
. Using Replacement Characters 


The asterisk (*) and the question mark (?) May be 
used as replacement characters in a file name or 
file name extension to create an ambiguous file 
reference, The format of the ambiguous file 
reference is the same as that of the single file 
reference (see section 1.3.2.1). 


The asterisk replaces any character(s) from the 
position it occupies, to the right, up to the next 
delimiter (i.e., period (.), question mark (?), or 
carriage RETURN). 


The question mark replaces any single character in 
the exact position it occupies. 


Notes: 


1) These replacement characters in no way alter the 
original file reference. They do not become part 
of the file name or file name extension. The 
asterisk and question mark serve only to refer to 
several files at once by creating an ambiguous file 
reference. 


2) These replacement characters may be used only in 
commands and programs as specified in this manual. 


- Examples: 
For the following examples, these single file 


references will be used: 
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PROG. FOR 
PROGRAM1. FOR 
PROGRAM2. FOR 
PROG. REL 

PROGRAM1.REL 
PROGRAM2.REL 


Ambiguous File Reference 


PROGRAM? .REL 


PROG*. FOR 


PROGRAM1.* 


* .FOR 
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Files Referred To 


PROGRAM1.REL 
PROGRAM2.REL 


PROG. FOR 
PROGRAM1.FOR 
PROGRAM2.FOR 


PROGRAM1. FOR 
PROGRAM1.REL 


All Files 
PROG. FOR 


PROGRAM1.FOR 
PROGRAM2. FOR 
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CDOSGEN 


Introduction and Features 


CDOSGEN is a very powerful feature of the Cromemco 
Disk Operating System. It allows CDOS to be built 
around the user's particular hardware configuration 
and software needs. As needs and equipment change, 
CDOS can be reconfigured in a matter of minutes to 
conform to a new hardware environment. > 


The ability to program sixteen individual console 
Function Keys gives CDOS, and all programs run 
under CDOS, a new flexibility. These programmable 
keys can be used to facilitate user interaction 
with the Word Processing System, Basic, Fortran, 
and CDOS itself. 


CDOS now supports up to 64 kilobytes of memory in 
1K blocks. CDOSGEN will design an operating system 
around any combination of up to 4 large and small 
disk drives. 


Generating a New CDOS 


CDOSGEN is run by responding to the CDOS prompt 
with "CDOSGEN". The file CDOSGEN.COM must be 
located on the current drive or on drive A if a 
disk drive specifier is not used. 


The program will prompt the user with questions 


concerning the desired system. Each of these 
questions is covered in the balance of section 2.2. 
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Memory Size 


After the header, the first prompt CDOSGEN will 
display is: 


Memory Size (3FFF - FFFF) ? 
There are two types of responses to this. 


The user may respond with a carriage return. This 
will cause the program to determine the amount of 
contiguous memory from 48@8H and generate an 
operating system based on this determination. The 
System thus generated will be the largest possible 
for the current hardware configuration. 


The user may alternately respond with a hexadecimal 
number in the range 3FFF to FFFF (inclusive) 
followed by a carriage return. The number entered 
specifies the highest address available to CDOS. 
For example, 7FFF would be entered for a 32K system 
(because this is the highest address of the top RAM 
card), BFFF for a 48K system, and FFFF for a 64K 
system. 


NOTE: The device I/O jump table and the bottom of 
CONPROC (i.e., the bottom address of CDOS) will 
always be loaded on an even 19@H byte boundary. 


Disk Drive Configuration 


After establishing the system size, CDOSGEN will 
query the user about the disk drive configuration 
with the prompt: 


How Many Disk Drives (1-4) ? 


Valid responses are any of the numbers 1, 2, 3, or 
4 followed by a carriage return. This number 
represents the total number of drives, both large 
and small, which are to be used with the generated 
system. 


. Next the user will be asked to specify the type of 


drive in each position. For this series of 
questions, it is assumed that Large (8 inch - model 
PFD) drives will always appear in the system in 
adjacent pairs (as A & B, B & C, or C & D), and 
that small (5 inch - model WFD or those delivered 
with the System 2) drives may stand alone (as A, B, 
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C, or D). 
The prompt for the drive type is: 
Drive X Type (S - Small, L - Large) - 
The X above stands for A, B, C, or D. The user may 
respond with either an "S" or "L" followed by a 


carriage RETURN. These stand for Small (5") and 
Large (8") drives respectively. 


Function Key Decoding 


The user is then asked to specify the type of 
Function Key decoding desired: 


Enter "S" For Standard Function Key Decoding 
"N" For No Function Key Decoding 
"U" For User Defined Function Key Decoding 


"F" For File Defined Function Key Decoding 
2? 


These various options are covered in the next 
sections. 


NOTE: The Function Key Decoding options are 
supported only by the Cromemco model 3181 terminal. 
Users who have not incorporated this terminal into 
their system should respond to this prompt with an 
A N a 


Standard Function Key Decoding 


Responding to the Function Key decoding prompt with 
an "S" will cause each of the Function Keys to 
issue a predefined standard command. These 
standard commands are: 
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Fl A:<CR> F9 STAT<CR> 

F2 B:<CR> F1@ EDITb 

F3 C3:<CR> Fll -BN”Z@P<CR> 
F4 D:<CR> F12 -BI<CR> 

F5 DIRb F13 XFER/Vb 

F6 TY PEb Fl14 XFER/Cb 

F7 * F15 DEBUG<CR> 


F8 -*<CR> F16 BASIC<CR> 


All Function Keys (except Fll and F12) are designed 
to be used in response to the CDOS prompt. Some 
(those terminated with a carriage RETURN <CR>) are 
stand alone Functions and will cause CDOS to 
respond. Others (those terminated with a blank 
(b)) will wait for the user to input a file 
reference followed by a carriage RETURN. Functions 
ll and 12 are designed to be used with the Text 
EDITor program. 


2.2.3.2 No Function Key Decoding 


Responding to the Function Key decoding prompt with 

an "N" will disable the Function Keys. This will 

also free space in CDOS (for drivers) and allow ( 
CDOS to occupy less memory after booting. 


2.2.3.3 User Defined Function Key Decoding 


Responding to the Function Key decoding prompt with 
a "U" will cause CDOSGEN to prompt the user for the 
desired decoding of each Function Key. In response 
to each prompt (Fl:, F2:, etc.) the user may enter 
any series of characters not including the ESCape 
character. In most applications, CTRL-Z may be 
Substituted for the ESCape character. The ESCape 
character terminates the current Function Key 
definition. 


Any command, response, or instruction may be 
entered as a Function. Then, when the Function Key 
is depressed, it will repeat the characters which 
were entered during the definition of the Function. 
Functions may be used while in CDOS, the EDITor, or 
any program using CDOS (i.e., System Calls) for 
console I/0. 


Referring to section 2.2.3.1 (Standard Function Key ‘ 
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Decoding) note that Function sequences may contain 
or be terminated with a carriage RETURN character 
which, in CDOS, will cause execution of the 
command. Function sequences may also be terminated 
with a blank, allowing the user to supply 
additional information as well as a terminating 


carriage RETURN. 


Function Keys may be programmed with a command line 
which includes carriage RETURNS. Thus Fl may be 
programmed with the sequence: 


DIR A:<CR> 
DIR B:<CR> 
<ESC> 


When the Fl key is then depressed, the directory of 


the disk in drive A will be listed followed by the. 


directory of the disk in drive B. 


2.2.3.4 File Defined Function Key Decoding 


The file referred to in response to this query must 
be an assembled file which defines each of 16 
Functions. 


Each Function definition contains the ASCII 
equivalent to the (command) line to be displayed 
when the Function Key is depressed and must be 
terminated by a -l (FFH). There must be 16 
terminators in the file or the message: 


Function Key Error 


will be displayed by CDOSGEN. 

Example: 
The following file was assembled (using the 
Cromemco Macro Assembler) and SAVEd on the disk as 


a COM file to give the standard CDOS function key 
decoding described in section 2.2.3.1: 
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222.4 


me Me 


STANDARD FUNCTION KEY DECODING FOR CDOS 
;NOTE THAT THIS FILE MUST CONTAIN 16 EOM'S 
7REGARDLESS OF ANY OTHER CHARACTERS IT USES. 


‘ 


f 

Fl: DB ‘'A:',CR,EOM 

F2: DB 'B:',CR,EOM 

F3: DB 'c:',CR,EOM 

F4; DB 'D:',CR,EOM 

F5: DB "DIR ',EOM 

F6: DB "TYPE ',EOM 

F7: DB '*' -EOM 

F8: DB '.*', CR,EOM 

FQ: DB "STAT" ,CR,EOM 

F1@: - DB "EDIT ',EOM 

Fll: DB '-BN',CTRLZ,'0P',CR,EOM 

F12: DB "-BI',CR,CTRLA,EOM 

F13: DB "XFER/V ',EOM 

F114: DB '"XFER/C ' ,EOM 

F15: DB "DEBUG ',EOM 

F16: DB "BASIC',CR,EOM 

‘ 

CTRLA: EQU 1 7CONTROL-A (AN EDIT COMMAND) 

CTRLZ: EQU 1AH ;CONTROL-Z (DELIMITER IN EDIT) 

CR: EQU 13 ; CARRIAGE RETURN 

EOM: EQU -1 ;END OF MESSAGE 
END 


Output File 


The Output File may either be a file reference 
using the file name extension SYS or a disk 
specifier (A:, B:, C:, or Ds) with no file 
reference. 


If a file reference is used, a standard CDOS file 
with the extension SYS will be created as specified 
by the user. In order to bring up the operating 
system which is contained in this file, the WRTSYS 
utility must be used to move the file to the System 
Area of the disk and then the system must be booted 
up. 


If a disk specifier alone is used in response to 
the prompt for an Output File, the file will be 
written to the System Area of the disk and will NOT 
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appear in the directory. In order to bring up the 
system which was just created, the disk upon which 
the system was written must be placed in the A 
drive and then booted up. The user will not be 
running under the new CDOS until it is brought into 
memory and this is not done until CDOS is reloaded 
(booted up). 


Note: In order to load (boot up) CDOS, the file 
CONPROC.COM must be present on the disk containing 
CDOS (the disk in drive A when the system is 
booted). An error message will be generated if it 
is not present. 


Reference is made to sections 4.2.5 (WRTSYS), 1.2.1 
(Disk Organization), and 3.1.4 (System Start-up). 


Addresses 


At the conclusion of. the CDOSGEN procedure, several 
important addresses are displayed. 


Starting address of CDOS - 
This is the bottom of CDOS before CONPROC is 


. loaded. After CONPROC is loaded, the bottom of 


CDOS will always fall on an even 256 (1@@H) byte 
boundary. 


Starting address of I/O drivers - 
This is the first location of the CDOS I/O drivers. 


Last address of CDOS - 


This is the highest address used by CDOS. Memory 
between this address and the highest address in the 
system may be allocated by the user. 


CDOS size (max = 198@H) - 

This is the Last address minus the Starting 
address. The maximum size of this area is fixed by 
the amount of disk space which is allocated to the 
System Area. 


27 


CROMEMCO DISK OPERATING SYSTEM USER'S MANUAL 
- 2 —- CDOSGEN 


WRTSYS Utility 


The WRTSYS Utility is the only program which will 


transfer files to and from the System Area of the 
disk. 


NOTE: The WRTSYS Utility does not transfer the 
file CONPROC.COM. It is necessary for this file to 
be present on the A drive whenever the system is 
booted up. CONPROC.COM must be transferred by 
means of the XFER Utility. 


Please refer to section 4.2.5 for a complete 
description of the WRTSYS Utility program. 
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CDOS Operation 


System Start-up 


4FDC Switch Settings 


A brief description of the function of each of the 
4FDC switches and their recommended setting 
follows. For further information on the 4FDC 
Switch settings please refer to the Cromemco 4FDC 
Disk Controller Manual (part number 023-9965). 


Switch 1 is the RDOS (PROM Resident Disk Operating 
System) DISABLE switch. When ON, the 
PROM containing RDOS cannot be accessed. 
When OFF, the PROM resides from CQ@@H to 
C3FFH in memory. This switch should be 
OFF for initial system operation. 


Switch 2 is the RDOS DISABLE AFTER BOOT switch. 


When ON, RDOS will automatically be 
disabled from address space following 
CDOS boot. When OFF, RDOS remains in 
memory at C@8@@BH following CDOS boot. 
This switch should be OFF for initial 
System operation. 


Switch 3 is the BOOT ENABLE switch. When ON, CDOS 
boot-strap is executed from power-on or a 
computer reset. When OFF, RDOS comes up 
when power is applied to the system or 
when the computer is reset. This switch 
should be ON for initial system 
operation. 


Switch 4 is the INITIALIZATION INHIBIT switch. 
When ON, diskettes cannot be initialized 
under software control. When OFF, disks 
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may be initialized. This switch should 
be OFF for initial system operation. 


NOTE: When configuring a system with 64 kilobytes 
of memory it is important that switch 2 be ON. 
This will disable RDOS after CDOS is booted up so 
that RDOS and system memory do not overlap at 
locations C@9OH to C3FFH. 


With switch 2 ON the only way RDOS can be re- 
entered after booting CDOS is by resetting the 
machine. If switch 3 is also ON the user will 
never be able to access RDOS because CDOS will 
automatically be booted up any time RDOS is called. 


ZPU Switch Settings 


The power-on jump should initially be set to CQ@@@H, 
the location of RDOS. To do this, the DIP switch 
should be set as follows: 


#15 = 1 
#14 = 1 
#13 = @ 
#12 = @ 


The clock switch should be set to 4MHz. 


16KZ Modification -64K System 


In a 64K system using 4 - 16KZ RAM cards, the high 
card must be modified. In order to avoid a 
conflict with RDOS (which is resident at COOO-C3FFH 
on power up or reset) the 16KZ card addressed at 
CO@@GWH must be disabled on power up and reset. 


This modification can be accomplished by attaching 
a jumper wire between IC3 pin 3 and Ic4 pin 4. 


For operation, the modified 16KZ card must have its 
Bank @ switch OFF and be addressed at C@@@H (A15 
and Al4 switches ON). 


Switch 2 on the 4FDC must be ON in order to disable 
RDOS after CDOS has been booted up and the modified 
16KZ card has been enabled. 
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System Start-up 


With all the circuit boards installed, the terminal 
connected, and the switches set as in the previous 
sections, the following procedure will load CDOS: 


1. Turn on power to the computer, terminal, 
and disk (if the system is using a model 
PFD). 


2. Place the CDOS system disk supplied with 
this manual in disk drive A. 


3. Press the carriage RETURN key up to four 
times to set the console baud rate. If 
Switch 3 is set to the ON position, CDOS 
will automatically boot up at this point. 
If switch 3 is set OFF RDOS will respond 
with a prompt (;) to which the user must 
respond with "B" and a carriage RETURN to 
boot up CDOS. 


The system is now up and running. 


Either of the above procedures is known as a Cold 
Bootstrap which includes reading CDOS and the I/0 


‘routines from disk. 


NOTE: It is advisable to insert the disks after 
powering-up and remove them before power ing-down 
the machine. The disks may be left in the drives 
when resetting the machine. 


2 ee ee, 


When a command is issued, the current disk drive is 
always referred to unless another drive is 
Specified in the command. The current or default 
drive can be changed by issuing the disk specifier 
followed by a colon (and a Carriage return to 
terminate). 


If drive A is the current drive and it is desired 
to make drive B the current drive, the user should 
type: 


B:<CR> 
and the console will display: Bes” indicating 
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that drive B is now the current drive. 


When a drive is FIRST selected in this way, the 
disk is logged in so the system knows what free 
space is on the disk. CDOS maintains an internal 
bit map of the unused (available) sectors on each 
disk. Whenever a disk is CHANGED, the new disk 
MUST be logged in by typing CTRL-C. THIS IS 


ESSENTIAL. If the new disk is not logged in, the 


old disk will still be logged in and the system 
will improperly write to the new disk. Note that 
CTRL-C is needed only when changing disks and not 
when specifying another drive. 


When a CTRL-C is issued, the system performs a WARM 
START which means it logs off all drives (resets 
the bit maps) and logs on drive A plus the current 
drive (if it is other than drive A). This means 
that the next time a particular drive is accessed a 
new bit map will be obtained. CTRL-C does NOT re- 
boot CDOS from disk. See the STAT utility program 
for a method of determining whether or not a disk 
has been written to improperly. 


NOTE: If a file with an extension of COM resides 
on drive A and that filename is given as a command, 
the system will find the file even if drive A is 
not the current drive. For example, if the Editor 


(EDIT.COM) resides on drive A, the file which is to. 


be edited (PROGRAM1.FOR) resides on drive C, and 
the current drive is drive C, the following command 
line will call the Editor from drive A and edit the 
user file on drive C: 


C.EDIT PROGRAM1. FOR 


Control Functions 


Certain non-printing (control) characters serve to 
control specific console and printer operations. 
These characters are described and summarized in 
the following sections. 


Note: A control character is entered on the 
console by holding down the CTRL key (as you would 
the shift key on a typewriter) and depressing the 
appropriate additional key (i.e., A for CTRL-A, C 
for CTRL-C, etc.). Because control characters are 
non-printing characters, they are displayed 
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symbolically on the console by the up arrow (%*) 
followed by the appropriate character. 


Console Control Characters 


Once the system is running, basic user interaction 
is with the CONsole PROCessor (CONPROC). This 
program takes care of file maintenance by means of 
intrinsic commands and utility programs (described 
elsewhere in this manual). The prompt given by the 
System is the disk identifier for the current drive 
(e.g., "A" for drive A). A command may be entered 
anytime the prompt is displayed. 


While typing a command, the standard buffer input 
mode is active and certain control characters are 
usable. To type a control character, press the 
CTRL key first and hold it in a depressed position 
(similar to a shift key) while typing the letter. 
Since a control character is non-printing, it is 
displayed on the console as the character preceded 
by an up-arrow (e.g. "“I"). Following is a list of 
control chracters and their functions: 


8 Physical carriage return and line feed, 
go to the next line without terminating. 


Backspace 

Underscore 

RUBout 

DELete any of these will delete the last 
character entered without echo. These 
will backspace the cursor on a CRT 
terminal. 

RETURN 

“M Either of these will terminate a command 
line. 

“R Retype current line (after many 
corrections). 

*s Pause during device I/O. This is 
primarily used to stop and re-start a 
listing on the console. Any key may be 
typed to resume processing, but only “S | 
‘can be used to pause. 

“U Delete the current line. 
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X Delete the last character with echo. 
This deletes and echoes the character 
following three backslashes; three 
forward slashes are generated by resuming 
typing. This is primarily used with 
hard-copy terminals. 


Printer Control Characters 


There are three control characters which are used 
to control output to the printer. They are: 


“N This character is only for use with 
Cromemco Printer model 37983. When this 
Character is included in a line which is 
sent to the printer, it will cause the 
entire line to be printed in double width 
characters. A line printed in double 
width characters may contain only half as 
many characters as a normal line. This 
is because each double width character 
takes up twice as much room as a normal 
character. 


“p Send all console output to the printer as 
well as to the terminal. This is a 
toggle action switch. If it is off, the 
printer is turned on by CTRL-P and vice 
versa. If a CTRL-P is inadvertently sent 
while a printer is either not connected 
to the system or not enabled, another 
CTRL-P will cancel the first one. 


is Turn off all output to the printer. This 
control character can be output by a user 
program but will have no effect if issued 
from the console. 


“WwW Send all output to the printer as well as 
to the console. This control character 
can be output by a user program but will 
have no effect if issued from the 
console. 
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Automatic Startup and Program Execution 


A very powerful feature of the Cromemco Disk 
Operating System (CDOS) is the ability to enter 
directly into an application program when powering 
up the computer. This is especially useful for the 
inexperienced user as there is no need to deal with 
any of the commands which are used to load and 
execute a program. 


The following procedure will cause the BASIC user 
program START.SAV to automatically begin execution 
when CDOS is entered. 


re Make sure that there is a copy of the 
batch command file '@.COM' on disk A. 


2. Save the BASIC program you want RUN in a 
file (in this example we are using 
START.SAV). The program must be SAVEd 
(not LISTed) in order for this to work. 


Our program for this example is: 


198 REM THIS IS MY APPLICATION PROGRAM 


1l1@ A= 5 
120 B= 19 
139 PRINT "THE ANSWER IS: "; A*B 
148 END 
3. Using the Cromemco Editor, create a file 


named STARTUP.CMD on disk A. Note that 
this must be named STARTUP.CMD as this is 
the file name that CDOS looks for. 


In this example, the command file should 
contain the line: 


BASIC START.SAV 


When CDOS is entered the batch command 
will call BASIC which will RUN the saved 
program 'START.SAV'. : 


4. When the computer is turned on and CDOS 
is entered (you have to depress the 
carriage return several times), our 
example will output the following: 
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A.@ STARTUP 
BATCH VERSION 69.83 


A.BASIC START.SAV 

CDOS 16K BASIC, VERSION 5.9 
THE ANSWER IS: 58 

*k*KLAQ END*** 


NOTE: While the STARTUP.CMD file is controlling 
the operation of the system the CTRL-C (warm start) 
function as well as RETURN (method of terminating a 
batch command) are both disabled. After the 
STARTUP.CMD file has finished, these two functions 
will be returned to their normal mode of operation. 
The disabling of these functions during the startup 
procedure can be useful in preventing the novice or 
unskilled user from inadvertently gaining control 
of the machine. 


See the batch (@) command (section 4.2.1) for 
further information. 


Command Structure and Syntax 


A request to CDOS is initiated by the user entering 
a command on the console. CONPROC processes the 
command to determine if it is one of the eight 
intrinsic commands (those commands which are 
internal to CDOS and are not saved as disk files - 

see section 4.1). If the command is intrinsic it 
is executed. If the command is not recognized as 
intrinsic, it is assumed to be a COMmand file on 
the disk and CONPROC attempts to locate the file 
with the COM extension. The current disk is 
Searched first, and if the file is not located, the 
disk on drive A is searched as a Master Library. 
If the program is found it is loaded into memory 
Starting at 180H, the remainder of the command line 
is passed to it as control information (see sec. 
5), and execution is started at 19@@H. If it is not 
found, a message to that effect is displayed on the 
console. 


~The command line starts with an optional disk drive 


specifier. If this is omitted, the default or 
current disk drive is assumed (except as noted 
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above). This is followed by the command with no 
extension (COM is assumed). The rest of the line 
is determined by the command. The following 
conventions are observed: 


Ve? ALA options are preceded by a slash (/) .. 


2. An assignment command follows this 
format: 


Destination-file-ref=Source-file-ref 


38 A comma, blank, or equal sign acts as a 
delimiter to separate filenames. 


4. All letters in command lines are 
translated into upper case upon entry. 
All filenames appear in upper case only, 
but may be referenced by any combination 
of upper and lower case characters. 


5. A blank will be ignored except as a 
delimiter separating filenames. 


Reset Switch 


Turning the key on a System Three computer to the 
RESET position or depressing the RESET switch on 
the back panel of a System Two computer causes a 
hardware reset. This causes control to be 
transferred to the power on jump address selected 
on the ZPU card. With the switches on the ZPU and 
4FDC cards set as suggested in sections 3.1.1 and 
3.1.2, resetting the computer will cause control to 
be transferred to RDOS and (if switch 3 on the 4FDC 
is ON) cause CDOS to automatically be re-loaded 
into memory (cold bootstrap). 


Note: After resetting the computer the carriage 


RETURN key must be depressed several times to re- 
establish the terminal baud rate. 
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Cromemco 3355 Daisywheel Printer Driver 


CDOS is supplied with a printer driver designed for 
use with Cromemco dot matrix printers (model 
numbers 3783 and 3779). If a dot matrix printer is 
part of the system, it will operate as specified in 
section 3.2.2 without any modification to CDOS. 


There are two ways to activate the 3355 Daisywheel 
printer driver. 


If the daisywheel printer is to be used with the 
Cromemco Text Formatter, the option @output=l must 
be specified at the beginning of the file which -is 
to be Formatted. This will cause the Formatter 
program to use an internal daisywheel’ driver which 
incorporates variable spacing to achieve margin 
justification. Refer to the Cromemco Text 
Formatter Instruction Manual, part number 923-9946 
for further information on the output (@o) command. 


If the daisywheel printer is to be used as the 
System printer, as specified in section 3.2.2, than 
the special driver which is supplied with the 
Cromemco model 3355 printer must be used. This 
driver is loaded by executing the program 3355.COM. 
The driver will remain loaded as long as the system 
is not rebooted. Once this driver is loaded, the 
dot matrix type of printer will not function with 
the system until CDOS has been reloaded. 


A procedure for loading the 3355 driver follows. 


After CDOS has been loaded, place the disk 
containing the file 3355.COM in the current drive 
or on. drive A. Then type CTRL-C. Finally type 
3355 followed by a carriage RETURN. A message will 
be displayed when the driver has been properly 
loaded. 
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CDOS Commands 


4.1 Intrinsic Commands 


The Intrinsic Commands are a part of the CONSole 
PROCessor. They reside in part of high memory 
occupied by CDOS after the system has been loaded. 
Because these commands are intrinsic to CDOS, their 
execution does NOT alter the uSer area. -All files 
referred to by Intrinsic Commmands are disk files. 


4.1.1 ATRIButes - 


ATRIB establishes or changes allowable file access 
modes. 


Format: ATRIB file-ref [+] [p...]. 


where: 
file-ref is a file reference which may 
include the * and ? replacement 
characters (see section 1.3.2.2). 
+ is an optional parameter which 
indicates that the following 
ATRIButes are to be added to those 
already describing the file. 
Poss are optional ATRIBute parameters. 


They are abbreviated by one or more 
of the following letters: 


E Erase protect. This file cannot be 
erased or renamed. 


R Read protect. The system cannot 
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read from this file. The file may 
be erased or executed. 


W Writé protect. The system cannot 


write to this file. The file may be 
erased or executed. 


ATRIButes may be deleted by assigning a new set of 
ATRIButes or by giving the ATRIB command with only 
a file reference and no optional parameters. This 
will cause all user assignable’ (erase, read, and 
write protect) ATRIButes to be deleted. Atributes 
may be added to those already existing by use of 
the '+' symbol. 


NOTE: ATRIB is a software protection against 
writing, reading, or erasing disk files. As such, 
it is possible to override this protection by using 
an older version of CDOS, using RDOS, etc. If more 
positive write protection is desired, the use of a 
write protect sticker is recommended. 


Examples: 


These examples assume that the following directory 
is on the current disk: 


PROGRAM1 FOR 7K ut 
PROGRAM2 FOR 18K 2. 
PROG 2K al 
PROGRAM1 REL 2K 1 
PROGRAM2 REL 5K 1 

5 Files **** 34K Gee es 


This directory indicates that none of the files 
have limited access modes (i.e., none of the 
allowable access modes have been altered by ATRIB). 
If the command: 


ATRIB *.FOR R 


is given, then the directory will appear as 
follows: 


PROGRAM] FOR 7K <A? 
PROGRAM2 FOR 18K 2R 
PROG 2K: 1 
PROGRAM] REL 2K Oo 
PROGRAM2 REL 5K 1 

5 Files **** 34K 6 *#kKX 


—_ 
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The command used an ambiguous file reference to 
refer to all files on the current disk with the 
extension FOR (*.FOR). The command instructed the 
ATRIB utility to make all the referenced files Read 
Protected (by means of the R parameter). The R 
following each of two directory entries indicates 
that PROGRAM1.FOR and PROGRAM2.FOR have been given 
a Read protect status. If, following this, the 
command: 


ATRIB PROGRAM1.FOR +EW 


is given, then the directory will appear as: 


PROGRAM1 FOR 7K 1 EWR 
PROGRAM2 FOR 18K 2 R 
PROG 2K Oo 
PROGRAM1 REL 2K 1 
PROGRAM2 REL 5K 1 

5 Files **** 34K 6 *kkk 


This time ATRIB used a single file reference 
(PROGRAM1.FOR). The command added (by means of the 
plus sign) categories of protection to the already 
existing category. The EWR following the file 
entry in the resulting directory indicates that the 
file PROGRAM1.FOR is now Write and Erase protected 
in addition to its previous status of being Read 
protected. If the plus sign had been omitted from 
the parameters specified for this command, the file 
would no longer be Read protected as the Write and 
Erase protect would have replaced, not have been 
added to, this status. 


BYE 


The BYE command forces a return to RDOS. Once in 
RDOS, control may be returned to CDOS by typing B 
(for Boot) or GZ (for GO Starting at location @). 
In addition, any of the other RDOS commands may be 
used at this time (i.e., Display Memory, Substitute 
Memory, etc.). Note that the BYE command will not 
work if switch 1 or 2 of the 4FDC is ON. 


Format: BYE 
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DIRectory 


DIR lists disk file names and sizes followed by a 
summary of the total disk space used by the files 
which were listed. 


y: 
Format: DIR [ ] 
file-ref 
where: 
y is an optional disk drive specifier. 


When included in the command line 
this parameter will specify the 
drive whose disk directory is to be 
examined. When omitted, the DIR 
command will default to the disk in 
the current drive. Legal values are 
A, B, C, and D. 


file-ref is an optional file reference which 

, may include the * and ? replacement 
characters (see section 1.3.2.2). 
When this parameter is included, 
only file name(s) which match the 
file reference will be listed. 


The directory is listed in the following format: 


PROGRAM1 FOR 7K a 
PROGRAM2 FOR 18K 2 
PROG 2K 1 
PROGRAM] REL 2K 1 
PROGRAM2 REL 5K 1 

5 Files **** 34K 6  SFRAK 


Each line of the directory listing (except for the 
last line) includes: 


1. the filename, 
2. the filename extension (if one exists), 
3. the length of the file in kilobytes, and 
4. the number of extents (16K blocks) 

- occupied by the file. 


The last line of the directory is a summary of the 
listing. This is not always the same as a summary 
of all of the files on the disk. The summary line 
includes the total number of files, kilobytes, and 
extents which were listed. 
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Examples: 


Assmume that the DIR command, given without any of 
the optional parameters, will yield the following 
Directory: 


PROGRAM1 FOR 7K 1 
PROGRAM2. FOR 18K 2 
PROG 2K 1 
PROGRAM1 REL 2K 1 
PROGRAM2 REL 5K 1 

5 Files **** 34K G #EKKE 


This is a listing of the names of all of the files 
on the current disk. If the current drive is not 
drive C, the command: 


DIR C: 
might yield the following directory: 


FILENAME BAS 5K dL 
BASIC COM 19K 2 
3 


2Files **** 24K kKkeKREKK 


This is a listing of the names of all of the files 
on the disk in drive C. 


The following command would give the user the names 
of all of the REL files on the current disk: 


DIR *.REL 
The directory would appear as: 
PROGRAM] REL 2K 1 


PROGRAM2 REL 5K 1 
2 Files **%** 7K 2 KKK 
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ERASe 


-ERA deletes file(s) from a disk directory. 


Format: ERA file-ref 
where: 


file-ref is a file reference which may 
include the * and ? replacement 
characters (see section 1.3.2.2). 
All file(s) which match the file 
reference will be deleted from the 
disk directory. The space on the 
disk which the erased files had 
occupied will then be available for 
other use. 


Note: It is possible to delete a great many files 


-at one time using an ambiguous file reference. 


Caution is recommended when uSing replacement 
characters in the ERAse command file reference. 
Prior to issuing the ERA command, the DIR command 
may be given with the same file reference in order 
to obtain a list of the files which will be deleted 
by the ERA command. 


Example: 
If the current disk drive directory is: 
PROGRAM1 FOR 7K 1 
PROGRAM2 FOR 18K 2 
PROG 2K 1 
PROGRAM] REL 2K 1 
PROGRAM2 REL 5K 1 
5 Files **** 34K Gi FRRER 


then the command: 
ERA PROGRAM1.* 


would erase the two files referred to by the 
ambiguous file reference. The resulting directory 
would appear as: 


PROGRAM2 FOR 18K 
PROG 2K 
PROGRAM2 REL 5K 

3 Files **** 25K 
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REName 


REN changes the file name and/or file name 
extension of an existing file. 


Format: REN new file-ref=old file-ref 
where: 


new file-ref is a file reference which may 
include the * and ?_ replacement 
characters (see section 1.3.2.2). 
This is the file reference which 
will exist in the disk directory 
after the execution of the command. 
NOTE: If replacement characters are 
used in the new file-ref, they will 
be replaced by characters from the 
file name and file name extension 
referred to by the old file-ref. 
Replacement characters never appear 
in an actual file name or file name 
extension. 


old file-ref is a file reference which may 
include the * and ?_ replacement 
characters (see section 1.3.2.2). 
This is the file reference which 
existed in the disk directory before 
the execution of the command. 


Initially, this command verifies that no file 
exists on the disk which satisfies the new file- 
ref, If the new file-ref includes a replacement 
character, any existing file which satisfies the 
ambiguous file reference will cause the message 
"File already exists' to appear and command 
execution will be aborted. After this initial 
check, no further file reference checking takes 
place. It is possible, in a multiple REName 
command, to create more than one file with the same 
file reference. It is up to the user to ensure 
that this does not happen. 


Examples: 


Assume the directory on the current disk drive 
appears as follows: 
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PROGRAM1 FOR 7K 1 
PROGRAM2 FOR 18K 2 
PROG 2K 1 
PROGRAMI REL 2K 1 
PROGRAM2 REL 5K 1 

5 Files **** 34K 6 *EeeS 


If the files PROGRAM1.FOR and PROGRAM2.FOR are to 
be used as text files and the user wants to have 
their extensions reflect this, the following 
command will change each file name extension of FOR 
to TXT on the current disk. 


REN *.TXT=*.FOR 


If, in addition, the user desired to change the 
name of the file PROG to PROGRAM.FOR the following 
command line would be entered: 


REN PROGRAM. FOR=PROG 


After giving ‘these two commands, the directory 
would appear as: 


PROGRAM1 TXT 7K 1 
PROGRAM2 TXT 18K 2 
PROGRAM FOR 2K 1 
PROGRAM1 REL 2K a 
PROGRAM2 REL 5K 1 

5 Files **** 34K 6 


KEKE 
SAVE 


SAVE causes part of the user area to be saved on 
disk. 


Format: SAVE file-ref n 


where: 

file-ref will become the name of the SAVEd 
disk file. 

n ‘is the decimal number of 256 byte 


pages to be saved. 


After linking a FORTRAN, COBOL, or Assembler 
program and before beginning execution the SAVE 
command may be issued to create a COMmand file. A 
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COMmand file may have any file name and must have 
the file name extension 'Com'. 


The number of pages to be saved is displayed by the 
linker as the last of a series of three exit 
Parameters enclosed in a set of brackets. 


It may also be computed by converting the two high 
digits of the highest address to be saved to 
decimal (e.g., if the user area is to be saved 
through address @BFFH, convert @B to decimal (11) 
and save 11 pages). 


Remember that the user area starts at 18@H and that 
the SAVE command saves from this address on. 


TYPE 


TYPE causes an ASCII file to be output to the 
console (and optionally to the printer). 


Format: TYPE file-ref 
where: 
file-ref is the file to be TYPEd. 


Note that only ASCII files may be TYPEd and that an 
attempt to TYPE a binary (i.e., relocatable or REL) 
file will yield unpredictable results. 


During the execution of this command all of the 
applicable Console Control Functions (see section 
3.2.1) will be in effect. CTRL-S will cause the 
listing to pause, CTRL-P will cause the listing to 
go to the printer, and any other character will 
abort an active listing. Note that any character 


will restart a listing which has paused in response. 


to a CTRL-S. 


If a CTRL-W is included in the file to be TYPEd, 
all output following this character will be sent to 
the printer as well as the console. Output to the 
printer may be stopped by using the CTRL-T 
character. 
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Utility Programs 


Utility Programs are NOT part of CDOS. They reside 
on the disk as COMmand files which can be called 
into the user area as desired. As opposed to 
Intrinsic Commands, execution of Utility Programs 
DOES alter the user area.- 


@ (Batch) 


The Batch (@) command allows the user to execute a 
file of commands from CDOS. In addition, in the 
immediate mode, it allows the user to create a file 
of commands for one time execution. 


Format (one time mode) : 
{x:]@{[/R] [/y] <CR> 


Format (file mode): 
[x:]@{/R] [/y] {file-ref] [pl p2...p9] 


where: 


=x is an optional disk drive specifier 
indicating the location of the batch 
COM file (@.COM). This parameter is 
required only if the COM file is 
NOT located on either drive A or the 
current drive. Legal values are A, 
B, C, and D. 


R is -an optional recursive Batch 
function switch. If this option is 
invoked it allows Batch command file 
1 to call Batch file 2 and to return 
to Batch file 1 when Batch file 2 is 
completed. If this switch is not 
set processing will stop when 
execution of the second file has 
been completed. The nesting level 
is only limited to a maximum of 128 
commands pending at one time. — 


y is an optional disk drive specifier 


indicating the location of the Batch 
work file. 


p is an (are) optional parameter(s) to 
be passed to the CMD file. 
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Batch takes its commands sequentially from a file 
containing all of the commands which are to be 
executed. The Batch command will create its own 
temporary command file (filename.$$$) when used in 
the one time mode and will prompt the user with an 
exclamation mark (!). Valid responses include all 
legal responses to the CDOS prompt. Execution of 
the batch command file will commence when a 
carriage RETURN is entered in response to the 
prompt. 


When used in the file mode, the Batch command 
references an ASCII file containing a list of CDOS 
commands. This file must have a file name 
extension of CMD. 


The parameters Pg through P9 are inserted wherever 
“6, “1,...°9 appear(s) in the CMD file. 


Note: These are not control characters, but rather 
are the two separate characters, up arrow (7%) 
followed by a number. 


Parameter @ stands for the command file reference 
and with it you may refer to the CMD file reference 
itself. Parameters 1 through 9 are those in the 
command line. These parameter numbers may be 
repeated in a file. The up arrow itself is 
represented in the command line by two successive 
up arrow characters, only one of which is 
transmitted. “ 


When the Batch command line is given, each word 
after the filename is treated as a parameter. More 
complex parameters may be enclosed in single 
quotation marks. If too many or too few parameters 
are given, Batch ignores either the extra 
parameters or the extra commands, respectively. 


Examples: 


The one time mode can be used to issue a long 
string of commands which are to be executed without 
user intervention. The user might issue the 
following sequence at the console (the A. is the 
CDOS prompt while the ! is the Batch one time mode 
prompt) : 
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A.@<CR> (Batch - one time mode) 
!DIR<CR> - (types the DIRectory) 
!TYPE PROGRAM1.FOR<CR> (types the file) 

!REN TEMP=PROGRAM1. FOR<CR> (renames the file) 
!<CR> (begins execution) 


Following the null line, Batch immediately begins 
execution of the three commands issued, giving the 
command line for each one just prior to execution. 


In the file mode, Batch allows the user to create a 

‘file containing the desired command stream and to 
execute this file as often as desired. As the 
following example demonstrates, this can be useful 
for making a backup CDOS disk. The file used by 
Batch may be created using the Text EDITor and 
must have an extension of CMD to be found by Batch. 
In this example, the file used by Batch is called 
COPY.CMD and contains: 


XFER/V B:*.COM=A:*.COM 
DIR B: 


The user inserts a blank diskette containing only 
the CDOS resident image (refer to sections 1.2.1 
and 4.2.5) into drive B while the master copy of 
the CDOS COM files is in drive A, types CTRL-C, and 
then the Batch command: 


@ COPY 


The system then copies all files with the file name 
extension COM from the disk in drive A to the disk 
in drive B. The copy routines are followed by a 
directory so the user may verify that all the 
desired files have been copied. 


Suppose the user creates (using EDIT) a file called 
EXAMPL.CMD containing the following: 


DIR “1 
REN OLDFILE*2 


The user then types: 
@ EXAMPL NEWFILE '=NEWFILE' 


to which the system then types the directory 
listing NEWFILE (along with its size) followed by: 


REN OLDFILE=NEWFILE 
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4.2.2 


and continues by renaming NEWFILE. The equal sign 
(=) was included in the single quotation marks so 
that it could be passed as part of the second 
parameter. 


DUMP 


DUMP is used to display the contents of a file by 
128 byte records. 


Format: {x:]DUMP file-ref 


where: 

x is an optional disk drive specifier 
indicating the location of the DUMP 
COM file. This parameter is 
required only if the COM file is 
NOT located on either drive A or the 
current drive. Legal values are A, 
B, C, and D. , 

file-ref is the file to be DUMPed. 


The file is DUMPed in hexadecimal with the first 
address of a line displayed along the left margin 
and the ASCII characters corresponding to the hex 
displayed as characters on the right margin. When 
a binary file is DUMPed, the ASCII display is 
meaningless. 


Unlike the TYPE intrinsic, both ASCII and binary 


files may be DUMPed. The records are numbered 
starting with @. 


INITialize 
INIT is used to INITialize or format (i.e., number 
the tracks and sectors) large and small floppy 
diskettes (disks). 

Format: {x:]INIT 


where: 


x is an optional disk drive specifier 
indicating the location of the INIT 
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COM file. This parameter is 
required only if the COM file is 
NOT located on either drive A or the 
current. drive. Legal values are A, 
B, C, and D. 


Switch 4 on the 4FDC card must be OFF for this 


program to execute to completion (see section 
3.1.1). 


This program will prompt the user to obtain the 
information it requires. In response to a request 
for a drive letter, A, B, C, or D must be entered. 
This is the drive in which the disk to be 
initialized must be placed (a carriage RETURN typed 
in response to this question will abort INIT and 
return control to CDOS). Next the program will 
request information on the size of the disk. 
Before responding to this question, make certain 
that the disk which requires formatting is in place 
in the drive. Answer 'y' if the disk is a 5 inch 
mini floppy disk. Answer 'N' if the disk is an 8 
inch large floppy disk. A carriage RETURN typed in 
response to the prompt for a drive number will 
terminate execution of the INIT program and return 
the user to CDOS. See section 7 for an explanation 
of any error messages which may be displayed. 


Cromemco 8 inch floppy disks are supplied already 
formatted according to the IBM 3748 Data Entry 
System Format. It is recommended that the user 
NOT re-initialize these disks when new. Blank 5 
inch floppy disks require initialization before 
use. Occasionally any disk may require re- 
initialization due to magnetic damage. 


Note: Formatting a disk will destroy any 


information which may have been present on the 
disk. 
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STATus 


STAT displays any errors in the disk directory. In 
addition, it summarizes the use of disk and RAM 
space, 


Format: [x:]STAT [y:] 
where: 


x is an optional disk drive specifier 
indicating the location of the STAT 
COM file. This parameter is 
required only if the COM file is 
NOT located on either drive A or the 
current drive. Legal values are A, 
B, C, and D. 


y is an optional disk drive specifier 
indicating the disk whose directory 
is to be examined. Legal values are 
A, B, C, and D. 


STAT displays information for the default disk 
drive unless the optional disk drive specifier is 
used. The program informs the user of: 


1) the total amount of disk space 
available for user files (81 K bytes 
for small disks and 241 K bytes for 
large disks), 


2) the size of the User Area, 


3) the amount of unused disk space 
(space available for user files), 


4) the number of directory entries, 


5) the names of any null files (these 


files contain no information and may 
be deleted), and 


6) any disk errors. 


STAT runs a validation of the disk directory to see 
if any cross-linked files have been created or any 
clusters have not been allocated. These errors are 
caused by failing to depress CTRL-C after changing 
disks. 


\ 
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WRTSYS 


WRTSYS is used to write to or read from the CDOS 
resident image at the front of a system disk (see 


section 1.2). 


ds: £: 
Format: ([x:]WRTSYS[/S] = 
file-ref-l file-ref-2 
where: 
x is an optional disk drive specifier 


file-ref-l & 
file-ref-2 


indicating the location of the 
WRTSYS COM file. This parameter is 
required only if the COM file is 
NOT located on either drive A or the 
current drive. Legal values are A, 
B, C, and D. 


is an optional switch indicating 
that the system is to be written 
from one disk to another disk, but 
that only one disk drive is to be 
used. The program will prompt the 
user for insertion of the second 
disk. 


is a disk drive specifier indicating 
the disk upon which the CDOS 
resident image is to be written. 
Using this specifier alone indicates 
that CDOS is to be written to the 
System Area of the disk. 


is a disk drive specifier indicating 
the disk from which the CDOS 
resident image is to be copied. 
Using this specifier alone indicates 
that CDOS is to be copied from the 
System Area of the disk. 


are each file references indicating 
the source and destination files 
respectively. Using a file 
reference indicates that CDOS is to 
be copied to or from the File Area 
of the Disk. 
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The following conventions apply to both the left 
(destination) and right (source) sides of the equal 
sign. If only a disk drive specifier is used, the 
CDOS resident image is copied to or from the System 
Area of the disk. Refer to section 1.2.1 for a 
discussion of the System Area vs. the User Area of 
the disk. If a file reference is used it must have 
a file name extension of SYS. In this case, the 
system will be written to or from a User File on 
the disk. 


Note: Using the WRTSYS program to copy any system 
files does not change the CDOS which is resident in 
the computer. To change the operating system in 
use, CDOS must be rebooted (see section 3.1.3). 


Examples: 


The command: 
WRTSYS B:=A: 


will copy CDOS from the System Area of the disk in 
drive A to the System Area of the disk in drive B. 
The WRTSYS program will be read from the current 
disk or, if there is no WRTSYS program on the 
Current disk, from the disk in drive A. 


The command: 
D:WRTSYS A:=B:DOSMAX48.SYS 


will copy DOSMAX48.SYS from the File Area of the 
disk in drive B to the System Area of the disk in 
drive A. The WRTSYS program will be read from the 
disk in drive D. 


The command: 
WRTSYS A:SPECIAL.SYS=A: 


will copy CDOS from the System Area of the disk in 
drive A to a file called SPECIAL.SYS in the File 
Area of the same disk. The WRTSYS program will be 
read from the current disk or, if there is no 
WRTSYS program on the current disk, from the disk 
in drive A. 
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4.2.6 XFER 


The XFER program transfers files from a disk or 
other device to another disk or other device. It 
can be used in one of two modes. The repeat mode: 


Format: [x:]XFER<CR> 


will repeatedly prompt the user with an exclamation 
mark (!). Valid responses to this prompt are the 
same as the portion of the command line following 
the switches when XFER is used in the one-time 
mode. 


The one time mode will complete one (set of) 
transfer(s) per command and can be used with the 
optional switch(es). 


Formats: 


da: 
{x:]XFER[/sl/s2...] = file-ref-2[,file-ref-3...] 
file-ref-l 


where: 


X is an optional disk drive specifier 
indicating the location of the XFER 
COM file. This parameter is 
required only if the COM file is 
NOT located on either drive A or the 
current drive. Legal values are A, 

B, C, and D. 


$1,S2... are any number of the following 


optional switches (each must be 
preceded by a slash): 


A ASCII file transfer. 


Cc Compare files without transfer. 
This operation is driven by the 
source (file-ref-2) file. If file- 
ref-2 is shorter than file-ref-l, 
and the two files are identical for 
the length of file-ref-2, then the 
two files will compare as the same. 


F Filter out illegal ASCII characters 
(ASCII files only). 


I Ignore ASCII end of file (CTRL-Z). 
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R Read protected file is to be 
transferred. 

s Strip all rubouts and nulls from 
file (ASCII files only). 

T Tabs are expanded (ASCII files 
only). 

V Verify files after transfer. 

Z Do NOT print size statistics at 


completion of XFER. 


d- is the destination disk drive 
specifier. If used alone, the 
original names and extensions of any 
files transferred will be 
preserved. 


file-ref-1 is the destination file reference 
which may include the * and ? 
replacement characters (see section 
1.3.2.2). If replacement characters 
are used the portion of the 
destination file reference which is 
ambiguous will match the source 
file. 


file-ref-2,3... is (are) the source file 
reference(s). If only one file 
reference is used, it may include 
the * and ? replacement characters 
(see section 1.3.2.2). 


If more than one single file reference is given as 
the source, the files will be concatenated. If 
ASCII files are concatenated, the /A switch must be 
used to remove the end of file markers from between 
the files. 


An ambiguous transfer with verification will be 
terminated by a verification error. 


NOTE: The XFER utility will only transfer files to 
and from the File Area of the disk. The WRTSYS 
utility must be used to write system files to and 
from the System Area of the disk (see section 
1.2.1). 
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Examples: 


The command: 
XFER/V B:=PROGRAMI1.FOR 


will copy and verify PROGRAM1.FOR from the current 
disk to disk B. The copied file will have the same 
file name and file name extension as the source 
file. The XFER program will be read from the 
current drive or drive A. 


The command: 
XFER B:=A:*.FOR 


will copy all files with the file name extension 
FOR from drive A to drive B. Each of the copied 
files will have the same file name and file name 
extension as each of the source files. The XFER 
Program will be read from the current drive or 
drive A. 


The command: 
XFER D:* .TXT=A:* TYP 


will copy all files with the file name extension 
TYP from drive A to drive D. Each of the copied 
files will have the same file name as each of the 
source files, but will have the file name extension 
TXT. The XFER program will be read from the 
current drive or drive A. 


The following command will copy all files from 
drive A to drive B and then verify these copies: 


XFER/V B:=A:*.* 


The XFER program will be read from the current 
drive or drive A. 
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MEMTEST 


MEMTEST is a diagnostic program designed for 
testing memory. The following sections describe 
the use of MEMTEST as well as output generated by 
the program. 


4.2.7.1 Using MEMTEST 


The Memory Test performs various checks on 16K 
blocks of memory addressed at 4@00H, 80@090H, or 
C@@G@H. In order to run MEMTEST, there must be RAM 
addressed at @ in all banks. Load and begin 
execution of MEMTEST by typing MEMTEST in response 
to the CDOS prompt. The disk file MEMTEST.COM must 
be located on the current drive or on drive A. The 
test program will prompt with: 


BANK: 


In response, the user should enter the bank number 
in which the blocks are to be tested followed by a 
Space. MEMTEST will then prompt with: 


16K BLOCK:.. 


The user should enter 4, 8, or C (or any 
combination of these numbers with spaces in 
between) followed by a carriage RETURN. The 4 
indicates that the 16K block of memory starting at 
4990H in the specified bank is to be tested. The 8 
or C indicates the block starts at 8099H or COOH. 


After this carriage RETURN, MEMTEST will prompt the 
user for additional 16K blocks in other banks. If 
no further blocks are to be tested, the user should 
enter a carriage RETURN in response to the BANK 
prompt. If an entry error is made, a question mark 
(?) will be displayed and the user will be re- 
prompted. 


MEMTEST continues testing until the user terminates 
the test (see Control Functions Section ~ 4.2.7.3) 


Example: 
The following responses to the MEMTEST prompts will 
check 16K blocks of memory starting at 8@8@H and 
CO@@GH in bank @ and at 4000H, 89000H, and COOBH in 
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bank 7. 


BANK:@ 16K BLOCK:8 C<CR> 
BANK:7 16K BLOCK:4 8 C<CR> 
BANK: <CR> 


Tests 


MEMTEST performs five different tests on the memory 
being checked. 


The Peak Test shifts a one in a field of zeroes 
through the block. It loads a byte with one bit 
high into the top location of the block. The next 
location gets the byte shifted one position. After 
the high bit is shifted into the carry flag, the 
shift direction is reversed. Each byte is checked 
after it is written and again after the entire 
block has been loaded. The test is repeated for 
each of the 18 possible ways of loading this 
pattern. 


The Valley Test is similar to the Peak Test except 
that the test byte is a zero in a field of ones. 


The Delay Test checks long term memory retention. 
The block is filled with a pattern and then tested 
to see if it can retain the pattern for at least 
six seconds (at 4 MHz). The test is repeated for a 
number of different patterns. 


The Ml Test checks the capability of the block to 
be read during Ml machine cycles, 


The Bank Select Test determines in which bank the 


block of memory appears and tests the Bank Select 
circuitry of the card. 
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4.2.7.4 


Control Functions 


During execution, MEMTEST accepts the following 
input characters: 


CTRL-P causes MEMTEST to display (Print 
out) an image of the 16K block 
currently being checked. After the 
display, the test continues from 
where it was interrupted. 


ESCape causes a display of the current 16K 
block image and the termination of 
the current test with a prompt for a 
new test. 


CTRL-S causes the remainder of a print out 
to be Skipped. The test continues 
as if the print out had finished. 


CTRL~O causes MEMTEST to abort (Quit) and 
return control to CDOS. 


CTRL-E prints out an Error history showing 
which cards have had failures since 
the test began. 


Error Print Out 


If errors occur in the Peak, Valley, or Delay Test, 
an image of the card will be displayed indicating 
the physical locations of the ICs in which the 
errors occurred. The letter displayed as an error 
message indicates the test in which the error 
occurred. The Ml and Bank Select Tests are made 
only if there are no errors in the first three 
tests. 


Example: 
The following display indicates that errors 
occurred in bits 1 and 3 of rows 1 and 2, 


respectively, of the block of memory starting at 
C@8@ in bank 7: 
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This display indicates a possible problem in the 
RAM chips located in the same physical positions on 
the board as the PVD messages on the display. For 
proper reference, the user must face the component 
side of the card. 


Cromemco Text EDITor 


The Cromemco CDOS Text EDITor enables the user to 
create, edit, and save ASCII text or program files. 
The Text Editor is very versatile in that it can be 
used to manipulate and edit text on a line, word, 
or character basis. Characters and words can be 
inserted in, deleted from, or changed within a line 
of text. The point of change can be chosen to be 
between any two characters. Insertions and 
deletions can be made that cover more than one line 
of text. The Text Editor is not encumbered by line 
numbers or other extraneous information, and 
operates using only the text itself as a guideline 
to changes. 


The user who is not familiar with the CDOS Text 
Editor is referred to the Cromemco Text Editor 
Instruction Manual (part number 923-9946). In 
particular, Chapter II will aid the novice user by 
means of an example of an actual EDIT session. 
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Programmer's Guide 


Introduction to CDOS System Calls 


To a programmer, system calls are the single most 
important feature of CDOS. The user writing 
assembly language programs to run under CDOS should 
become familiar with the use of system calls. 


A system call is a call to the operating system 
which initiates a function, usually involving one 
of the I/O devices. The most important system 
calls perform I/O with, and manipulate, the floppy 
disk drives. CDOS also has system calls to perform 
device I/O with CRTs, printers, punches, and 
readers. System calls are available to perform 
such special purpose functions as storing and 
reading the date or time of day and multiplying and 
dividing integers. 


Because CDOS is designed to handle all I/o 
functions in a manner which is independent of 
System size and configuration, programmers should 
ordinarily do all I/O through the operates system 


‘by means of system calls. 


A system call is executed by loading the C register 
with the number of the call (refer to Section 
5.1.5) and loading any entry parameters into the 
specified registers. Upon execution of a CALL 5 
instruction, CDOS will perform the desired 
function. When CDOS has finished, it will return 
to the user program with a RET instruction. 


All 286 registers will be preserved by system calls 
except the F (Flag) register and those containing 
Return Parameters. The Z8@ set of Primed 
Registers are not used by system calls and hence 
programs may safely use these registers for 
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temporary storage. Entry Parameters are preserved 
by system calls unless otherwise noted in sections 
5.1.2 through 5.1.4. 


For more detailed information on how system calls 
index into the operating system, refer to the CDOS 
Memory Allocation section (5.3). For a summary of 
the system calls available with CDOS (listed in 
numerical order), refer to Section 5.1.5. The 
system calls are grouped under three general 
headings and described individually in detail in 
this chapter. They are also cross-referenced in 
the Index. 


Detailed List of CDOS System Calls 


The following is a detailed description of the CDOS 
system calls. They are sub-divided into three 
sections. 


Section 5.1.2 covers Input/Output from/to all 
devices except disk drives. This includes the 
system console(s), printer, punch, and reader. 


The next section (5.3.3) covers the system calls 
used to access disk files. This includes functions 
to search for, create, rename, delete, open and 
close disk files. Also included are routines to 
read or write data, and a number of functions 
designed to manipulate the disk drives. 


Section 5.1.4 covers a number of additional calls 
which fit no specific category and include such 
functions as integer multiply and divide; set/read 
the date/time of day; and system abort and program 
link functions. 


The system calls given below are in numerical order 
in each of the three sections. 


All device and disk input and output should be done 
through the CDOS system calls. This allows user 
programs to be independent of physical devices or 
port assignments and assures that the program will 
be able to run on other Cromemco machines 
regardless of how I/0 devices are connected to 
those machines. If a change needs. to be made ina 
device driver, it has only to be done once in the 
system drivers and this change becomes effective in 
all programs which access that driver through the 
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5.1.2 


system calls. 


To use one of these routines the C register must be 
set to the function number given with the title of 
each instruction. The other registers are set up 
as that system call requires (for example, the E or 
DE registers usually contain the entry parameter 
passed). A CALL 5 instruction is then executed to 
carry out the function. Remember that CDOS 
initializes location 5 with a jump instruction. 
This is done so that the location of CDOS in memory 
is transparent to a user program. A program using 
the CDOS system functions does not therefore need 
to do a CALL to a particular address in CDOS. 


CDOS Device System Calls 


The system calls of this section involve device I/O 
with all devices except disk drives. The number 
given preceding each CDOS function is the number 
which should be loaded into the C register prior to 
the CALL 5 instruction. This number is given first 
in decimal and then in hexadecimal in parentheses. 


1 - READ CONSOLE (with echo) 


This call is used to retrieve a single character 
(one byte) from the console. The byte will be 
returned in the A register with the parity bit (Bit 
7) reset. CDOS does not return control to the user 
program until a character has been read and echoed 
back to the CRT. No entry parameters are required 
other than the value in the C register. 


Note that a CTRL-Z (“Z) character is usually to be 
considered by a user program as an end of file 
mark. Also, most other control characters will 
not be echoed back to the CRT and some have special 
meanings for the operating system. For example, 
CTRL-J (LF), CTRL-M (CR), and CTRL-G (BEL) are 
echoed directly, CTRL-I (TAB) is echoed as expanded 
Spaces (see WRITE CONSOLE below), and CTRL-P will 
toggle on/off a line printer but will not be 
echoed. . 
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2 ~ WRITE CONSOLE 


This call is used to write a single ASCII character 
(one byte) to the CRT. The character is placed in 
the E register before the call. CDOS will wait 
until the console is ready to receive the character 
and then print it. No parameters are returned by 
the call. 


After CTRL-P (“P) is typed while CDOS is outputting 
characters with this system call, all subsequent 
characters are sent to both the console and the 
printer until CTRL-P is depressed a second time 
(thus CTRL-P acts as a toggle switch). CTRL-w (“w) 
also causes subsequent characters to be sent to 
both the console and the printer but must be 
encountered in a file to do so. CTRL-T (*T) in a 
file cancels the effect of either the CTRL-W or the 
CTRL-P and causes characters to be sent only to the 
console. CTRL-W and CTRL-T may be edited into a 
file so when that file is being typed out on the 


console, it can stop and start the printer at the 


appropriate places. 


CTRL-I is the tab character and is converted to 
Spaces as it is typed out so that the cursor is 
Positioned at one of the standard tab stops: 
column 1, 9, 17, 25, 33, 41, 49, 57, 65, or 73. 
However, the tab is still stored internally in a 
file as a single ASCII character (9). 


3 - READ READER 


This call will read one character from a paper tape 
or card reader. All 8 bits are read and returned 
in the A register (i.e., the parity bit is not 
masked). No entry parameters are required other 
than the value in the C register. Since no card or 
paper tape reader is connected to a standard 
Cromemco computer system, the port assignments and 
method of interface (default is serial) for this 
System call are set up initially with the console 
as a reader. 


Also note that console status is checked during the 
read for the CTRL-S (*S) toggle, enabling the user 
to stop/start the reading process at will. This is 
useful for pausing during a paper tape jam, for 
example. 
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4 — WRITE PUNCH 


This call will punch one character on a paper tape 
punch. All 8 bits are punched (i.e., including 
parity). The character to be punched is placed in 
the E register before the call. CDOS will then 
wait until the punch is ready to receive the 
character. No parameters are returned by this 
call. 


Also note that console status is checked during the 
read for CTRL-S (*S), enabling the user to 
Stop/start the punching process. This is useful 
for pausing during a paper tape jam, for example. 


5 ~ WRITE LIST 


This call will print a single character (one byte) 
on the printer. The character to be printed is 
placed in the E-register before the call, and CDOS 
will wait for the printer to be ready before 
returning to a user program. No parameters are 
returned by this call. 


Tabs are not expanded, and control characters which 
do not have meaning to the printer will be 
transmitted anyway. Cromemco printers will ignore 
such control characters. A useful control 
Character for the Cromemco Model 3793 Printer is 
CTRL-N ("N), which, when present in a line of 
printer output, will cause that line to be printed 
in double width characters. 


Also note that console status is checked during the 


print out for the CTRL-S (*S) character, enabling 


' the user to stop/start the listing. This is useful 


for pausing to start a new box of line printer 
paper. 
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7 - GET I/O BYTE 


For extra I/O devices, an IOBYTE has been provided. 
This byte is not currently used by CDOS, but it is 
Provided for the user's programs. This system call 
returns the IOBYTE in the A register. The format 
of the byte is: 


Bit: Lt? | 6*4 & ) @ fF 3 7 2 } 2 1 @ 
Device: | PRN |] PUNCH | READER [ CONSOLE 


Thus up to eight consoles can be designated, four 
each of paper-tape punch and reader, and one 
printer. 


8 - SET I/O BYTE 


This call allows the user program to set the 
IOBYTE. The E register contains the byte prior to 
the call. See GET I/O BYTE for the format of the 
byte. 


9 - PRINT BUFFERED LINE 


This call will print a string of ASCII characters 
which has been terminated with the dollar sign (S$) 
character. The DE register pair is set up with the 
address of the beginning of the string before the 
call is made to CDOS. If the printer toggle is on, 
the line will also be sent to the printer. 


18 (®AH) - INPUT BUFFERED LINE 


This call will read an input line from the console. 
‘The DE register must be pointing to an available 
buffer before the call is made to CDOS. The first 
byte of the buffer must contain the maximum length 
of the buffer. On return from this call the second 
byte of the buffer will contain the actual length 
entered. The line that is input will be stored 
beginning at the third byte. If the buffer is not 
full, the byte at the end of the line will contain 
a zero. 


When the line is being. entered, the following 
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characters will have special meaning: 
CTRL-C (*C) Abort. Warm boot back to CDOS. 


CTRL-E (“E) Physical CR-LF. The line is 
not terminated and nothing is 
entered into the buffer. This 
character is used to enter a 
line longer than can be entered 
on the console. 


CTRL-P (“P) Toggle printer/console link. 
When this character is first 
typed, the link is toggled ON. 
All characters will then be 
sent to the console and the 
printer. The next time. the 
character is typed, the toggle 
will be turned off. All 
Characters will then be sent 
only to the console. 


CTRL-R (*R) Repeat what has been typed so 
' far on the line. 


CTRL-U (“U) Delete the entered line and go 
back to beginning of buffer for 
new line. 


CTRL~X (7X) Delete the previous character 
and echo the deleted character 
(used for hard-copy terminals). 


RUBout Delete the previous character 
and back up the cursor (used 
for CRT terminals). 


DEL Same as RUBout. 


Underscore Same as RUBout. 
Backspace (7H) Same as RUBout. 


69 


CROMEMCO DISK OPERATING SYSTEM USER'S MANUAL 
5 - Programmer's Guide 


11 (@BH) 


The console 


been typed. 


is tested to see 


- TEST CONSOLE READY 


if a character has 


If a character has been typed, @FFH is 


If no character has 


returned in the A register. 
been typed, @ is returned in the A register. 


128 (80H) - READ CONSOLE (without echo) 
This call is the same as READ CONSOLE (with echo) 
except that it does not echo the character after it 


is read. The byte is returned in the A register. 


142 (8EH) - SET SPECIAL CRT FUNCTION 

This call is used to perform special functions on 
the system console terminal. The call is designed 
to be very broad and include as many of the special 
features available in present-day intelligent 
terminals as possible. In particular it allows the 
programmer to take full advantage of the features 
available in Cromemco Model 318@ and Model 3191 CRT 
terminals. The call is executed by first loading 
the correct entry parameters into the DE register- 


pair. These values are summarized in the following 
table. No parameters are returned by this call. 
Mnemonic Function 

Address * address cursor on screen 

Clear * clear CRT screen 

Home * home cursor without clearing 

Back * move cursor to left one character position 
Forward * move cursor to right one character position 
Up * move cursor up one line 

Down * move cursor down one line 

Clear~EOL * clear from cursor position to end of line 
Clear-EOS * clear from cursor position to end of screen 
Highlight set intensity to high-light 

Lowlight set intensity to low-light 

Normlight set intensity to normal-light 


Keybd-on * 
Keybd-off * 
Cur pd-on 
Curpd-off 
Prtec-on * 
Prtec-off * 
Blink-on * 


enable keyboard 

disable keyboard 

enable cursor pad 

disable cursor pad 

begin protected field 

end protected field 
begin blinking characters 


76 


D E 
1-898 1-24 
1) 4) 
1 4) 
2 B 
3 4) 
4 ") 
5 4) 
6 4) 
7 My 
8 6 
9 Y) 
18 4) 
11 B 
12 4) 
13 ) 
14 @ 
15 4) 
16 4) 
17 4) 


CROMEMCO DISK OPERATING SYSTEM USER'S MANUAL 


5 - Programmer's Guide 
Blink-off * end blinking characters 18 
Line-send * send from cursor position to end of line 19 
Page-send * send from cursor position to end of screen 28 
Aux-send * transmit screen out auxiliary port 21. 
Del-char * delete character at present cursor position 22 
Insr-char insert character at present cursor position- 23 
Del-line delete line at present cursor position 24 
Insr-line insert line at present cursor position 25 
Formt-on * turn on formatted screen 26 
Formt-off * turn off formatted screen 27 
Rever-on begin reverse background field 28 
Rever-off end reverse background field 29 


Those features marked with an asterisk (*) above 
are all standard features of a Cromemco Model 3161 
System Terminal. Also note from the above chart 
that the E register is always loaded with @ to 
select any special CRT function except cursor 
addressing. For cursor addressing the D register 
should contain the column address (1 through 8®@ for 
Cromemco CRTs) and the E register should contain 
the row address (1 through 24 for Cromemco CRTs) of 
the desired cursor position. The system call will 
generate no error if these values are exceeded. 
Note: On some CRTs addressing the cursor at a non- 
existent location may cause it to disappear from 
the screen. 


For reference, the location (1,1) is considered to 


be the upper left-hand corner and the location 
(88,24) the lower right-hand corner of the screen, 
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5.1.3 CDOS Disk System Calls 


- CDOS divides the disk into regions called files. 
Files are referenced through file control blocks 
(FCBs). FCBS 


following format, 
stands for one byte: 


FCBDK Disk descriptor 


FCBFN 


FCBFT 


FCBEX 


FCBRC 
FCBMP 


FCBNR 


Note: 
.32 byte FCBs. 
to the next record, 


File name 


File type 
(extension) 


File entry 
or extent 


Reserved 
Record count 
Cluster 
allocation map 


Next record 


i) 


1...8 


Gecead 


12 


13...14 
15 


16...31 


32 


are 33 bytes long and have the 
where each of the numbers below 


(g@=current disk, 1l=drive-A, 
2=B, 3=C, 4=D) 


(right-filled with blanks) 
(right-filled with blanks) 


(initially 9; is incremented by one 
in every new entry of 16 Kbytes) 


(total number of 128-byte 
sectors or records) 


(allocated clusters 2 
through 248) 


(next record to be read or 
written; has the value 
@ through 127) 


The directory entries on the disk consist of 
The last byte, 
is omitted. 


FCBNR, which points 


12 (@CH) - DESELECT CURRENT DISK 


The 
driver 
function 


current disk 


is deselected. The CDOS disk 
can be changed to perform any desired 
at this 


time to deselect the disk. 
Currently the driver outputs a @ to port 34H when 
this function is selected. 
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13 (§DH) - RESET CDOS AND SELECT DRIVE A 


CDOS is initialized, all disks are logged-off, and 
drive A is selected as the current drive. The 
other disks will be logged-on again as soon as they 
are accessed. 


14 (®EH) - SELECT DISK DRIVE 


The disk drive number in the E register is selected 
as the current disk. The drive number in the E 
register is @ for drive A, 1 for drive B, 2 for 
drive C, or 3 for drive D. 


15 (@®FH) - OPEN DISK FILE 


The FCB pointed to by the DE register pair is 
opened to allow reading or writing to the file 
whose name is specified in the FCB. The A register 
returns with -l (@FFH or 255D) if the file is not 
found, or the directory block number if the file is 
found. Block numbers start at @ and there is one 
block number for every four directory entries. The 
DE register pair returns pointing to the directory 
entry in memory. 


16 (10H) - CLOSE DISK FILE 


The file described by the File Control Block 
pointed to by the DE register pair is closed, and 
‘the disk directory is updated (i.e., the FCB 
containing updated cluster information is written 
to the disk). The A register is returned with -1l 
(FFH) if the file is. not found on the drive, or the 
directory block number if the file is found on the 
stated drive. The file described by the FCB should 
have been previously opened or created. A file to 

' which bytes have just been written must be closed 
using this function or the entire last entry (or 
extent) will be unable to be read (i.e., no cluster 
information will be present for this entry in the 
directory). 
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17 (11H) - SEARCH DIRECTORY FOR FILENAME 


The directory is searched for the first occurrence 
of the file specified in the FCB pointed to by the 
DE register pair. ASCII question mark (? - 3FH) in 
the FCB matches any character. The block number 
(see description of directory block numbers in @FH 

- Open Disk File, above) is returned in the A 
register if found, if the file is not found -l 
(@FFH or 255D) is returned in A, HL is returned 
pointing to the directory entry in memory. An 
important point to note about this call and the one 
following (12H) is that they will get the directory 
entry whether it has been erased or not; i.e., 
these calls do not check to see if a file has been 
erased. Files are erased by placing a @E5H in the 
first byte (FCBDK); the rest of the FCB is left 
unchanged. 


18 (12H) - FIND NEXT DIRECTORY ENTRY 


This call is the same as 11H (17) above except that 
it finds the NEXT occurrence of the filename in the 
directory. This may be either the next entry of a 
file occupying several entries (extents), or 
another filename if the question mark match 
Character (?) is used in the FCB. This call is 
made after system call 17 and no other disk system 
function can be executed between these calls. 


19 (13H) ~- DELETE FILE 


The file specified by the FCB pointed to by the DE 
register pair is deleted from the disk directory. 
ASCII question mark (?) in the FCB matches any 
character. The number of directory entries deleted 
is returned in the A register. 
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28 (14H) - READ NEXT RECORD 


The DE register pair points to a successfully 
OPENED FCB. The next record (128 bytes) is read 
into the current disk buffer. The FCBNR in the FCB 
is incremented to read the next record. One of the 
following codes is returned in the A register: 


@ - read completed 


1 - end of file 


2 - read attempted on unwritten cluster 
(random access files only) 


21 (15H) - WRITE NEXT RECORD 


The DE register pair points to a successfully 
OPENED FCB. The next record (128 bytes) is written 
into the file from the current disk buffer. The 
FCBNR in the FCB is incremented to be ready to 
write the next record. One of the following codes 
is returned in the A register: 


@ - write completed 


1 - entry error (attempted to close an 
unopened entry) 


2 - out of disk space (limited to 81K for 
small; 241K for large) 


-l1 - (or FFH) out of directory space 
(limited to 64 entries) 


22 (16H) - CREATE FILE 


The file specified in the FCB pointed to by the DE 
register pair is created on the disk. The A 
register is returned containing the block number of 
the directory entry (see @FH - Open Disk File), or 


~l (@FFH or 255) if no more directory space is 
available. 
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23 (17H) - RENAME FILE 


This call will rename a disk file. The DE register 
pair points to the FCB to be renamed. The old file 
name and file type are in the first 16 bytes and 
the new file name and file type are in the second 
16 bytes of the FCB. ASCII question mark (?) in 
the FCB will match with any character. The A 
register returns containing the number of directory 
entries renamed. , 


24 (18H) - GET DISK LOG-IN VECTOR 


The A register is returned specifying the disks 
that are logged in. Each bit represents one disk 
drive logged in. If the bit is a one, then it is 
logged in; else it is off-line. The least 
significant bit is the A drive, next most 
Significant (Bit 1) is drive B, etc. Since there 
would be no more than four drives, the upper four 
bits are O's. 


25 (19H) - GET CURRENT DISK 
The number of the current disk drive is returned in 


the A register. .9@ = drive A, 1 = drive B, 2 = 
drive C, 3 = drive D. 


26 (1AH) - SET DISK BUFFER > 
The buffer pointed to by the DE register pair is 


used for disk I/O. When a program is loaded, the 
disk buffer is initially located at 8@H. 


76 


_ CROMEMCO DISK OPERATING SYSTEM USER'S MANUAL 
5 - Programmer's Guide 


27 (1BH) - GET DISK CLUSTER ALLOCATION MAP 


The BC register pair returns pointing to a bit map 
that corresponds to the allocated clusters on the 
disk. The DE register pair returns containing the 
capacity of the current disk in number of clusters. 
The A register returns containing the number of 
records or sectors per cluster (8). This system 
call.is used by the STATus utility program. 


131 (83H) - READ LOGICAL BLOCK 


This system call will read a logical block from the 
disk without any attention to the files it may 
contain (i.e., no FCB is specified). A block is 
defined to be one sector or record of 128 bytes. 
When this function is called, the DE register pair 
should contain the block number and the B register 
should contain the disk number (@ for current 
drive, 1-4 for A-D). The high bit of the B 
register contains a 1 for an interleaved and a @ 
for a non-interleaved read. Interleaved means the 
block which is read is found in the order CDOS 
Stores it (every fifth sector for small disks and 
every sixth sector for large disks). Non- 
interleaved means the block which is read is found 
in sequential order, the order it is physically 
Stored on the disk. The A register is returned 
with the status of the read according to the 
following: 


@ - OK 

1 - I/O error 

2 - illegal request 
3 - illegal block 


An example will help to illustrate the use of these 
parameters. CDOS makes use of 716 sectors on the 
small floppy disks. The block numbers which can 
legally be loaded into the DE register are @ 
through 715 decimal, or @ through 2CBH. Suppose 
that DE is loaded with the value 2 and the B 
register with @ (current disk, non-interleaved 
read). Thus, since the sectors are numbered 
beginning with 1, sector 3 would be read into 
memory in the disk buffer (located at 88H if it has 
not been changed). The same read with the B 
register loaded with 8@H (current disk, interleaved 
read) would read sector @BH (the third sector when 
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they are read every fifth one). 


132 (84H) - WRITE LOGICAL BLOCK 


This system call will write a logical block or 
sector to the disk without any attention to the 
file there (no FCB is specified). The registers 
are set up and returned in the same way as alae i are 
for the Read Logical Block system call. 


134 (86H) - FORMAT NAME TO FILE CONTROL BLOCK 


This system call will build a File Control Block. 
The HL register pair points to the start of the 
input line. The DE register points to the place in 
memory where the FCB is to be built. The input 
line is of the format: 


d:filename.ext 


where d stands for one of A-D, the filename is up 
to 8 letters with a 3 letter extension. The FCB is 
then built from this input line, converting lower 
case to upper case. The input line is terminated 
by an ASCII slash (/) or any character with an 
ASCII value less than 21H (such as a space or 
carriage return). 


On return the HL register pair points to the 
terminator that ended the build operation. The DE 
register pair points to the start of the new FCB. 


135 (87H) ~ UPDATE DIRECTORY ENTRY 


The last disk I/O function called must have been 
system call 17 or 18, Search Directory or Find Next 
Entry. The DE register pair points to the FCB used 
in the system call 17 or 18. The directory entry 
is then updated on the disk; this means that the 
entry is written back to the disk without the user 
having to specify a block. The user merely 
specifies a filename when calling 17 or 18. This 
is useful if it is desired to change a directory 
entry and write it back to the disk. 
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139 (8BH) - HOME DRIVE HEAD 


The disk drive specified in the B register (@ for 
Current drive and 1-4 for drives A-D) is sent a 
command to HOME the head. The disk drive head will 
return to track @,. 


148 (8CH) ~ EJECT DISKETTE 


This call will. eject the disk whose number is given 
in the E register (@ for current drive and 1-4 for 
drives A-D, respectively), only if the disk drive 
is a CROMEMCO Dual Disk Drive System, Model PFD 
with the eject option. Otherwise, the call will 
have no effect. 
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5.1.4 Miscellaneous System Calls 


A number of miscellaneous CDOS system calls have 
been added for the programmer's convenience. These 
calls are explained in this section. 


‘@ - PROGRAM ABORT 


This call will abort the current program and return 
control to CDOS. This call has the same effect as 
jumping to location @. 


129 (81H) - GET USER-REGISTER POINTER 


This call is provided for expansion of CDOS to a 
multiprogramming system. The BC register pair 
returns pointing to the user register pointers. 


138 (82H) - SET USER CONTROL-C ABORT 


When CTRL-C (“C) is typed, the system normally 
aborts and returns control to CDOS. This call 
allows the programmer to change the address to 
which control is transferred when CTRL-C is typed 
(i.e., a user may assign a new function to CTRL-C) . 
The address is given in the DE register pair. Note 
that if DE contains a zero, the system abort is 
reset. Jumping to location @ at any time still 
causes a return to CDOS, also with the CTRL-C being 
restored to its original function. 
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136 (88H) - LINK TO NEW PROGRAM 


This enables one command program to call another. 
The default command-line buffer and default FCBs 
for the new program must be set up prior to this 
call if that program expects to be able to use 
them. The DE register pair should contain the 
address of the FCB of the new program (which must 
have an extension of COM). If the new program is 
NOT found, the A register returns containing -1 
(@FFH or 255). In this case the first 8@H bytes 
(from 199H to 17FH) will be destroyed because this 
is used in reading the directory. If the program 
is found execution begins at 1@@H and no return is 
made to the original program. 


137 (89H) -— MULTIPLY INTEGERS 


This system call provides a 16 bit multiply. The 
HL and DE register pairs contain the two 16-bit 
factors, and the answer is returned in register DE 
(i.e., DE = DE*HL). 


138 (8AH) - DIVIDE INTEGERS 


This system call provides a 16-bit divide. The HL 
register pair should contain the dividend, and the 
DE register pair, the divisor. The quotient is 
returned in HL, and the remainder in DE (i.e., HL = 
HL/DE with DE = remainder). 


141 (8DH) - GET CDOS VERSION AND RELEASE NUMBERS 
This call will return the version number of CDOS. in 


the B register and the release number in the C 
register. 
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143 (8FH) - SET CALENDAR DATE 


This call is used to store the date (day/mon/yr) in 
CDOS. Upon entry to this call, the B register 
contains the day, the D register the month, and the 
E register the year minus 1990. These values will 
be stored in locations in CDOS where they may be 
accessed by user programs (through system call 144) 
and thus added to listings or other output. No 
Parameters are returned by this call. ~ 


The operating system makes no check for the 
correctness or plausibility of the incoming values; 
thus, it is up to the user to Supply this error- 
checking. Also, the date is not stored on the disk 
and is thus volatile (will be lost if the user re- 
boots or turns off the Power). 


144 (98H) - READ CALENDAR DATE 


This call-is used to retrieve the date (day/mon/yr) 

stored in CDOS by system call 143. The day is 

returned in the A register, the month in the B 
register, and the year minus 1998 in the Cc 

register. No entry Parameters are required other 

than the value in the C register. Note that the C 

register is changed by this call unlike most other 

System calls which preserve Cc. 


This is the function which should be used by a 
Program to recover the last previously stored date 
from the operating System. Note that if Set Date 
has not yet been used, Read Date will return the 
values 90/09/00. 


145 (91H) -— SET TIME OF DAY 


This call is used to store the time of day 
(sec/min/hr) in CDOS for use by a hardware clock or 
user program, Upon entry to the call, the B 
register contains the seconds, the D register the 
minutes, and the E register the hours in 24-hour 
time. These values will be stored in locations in 
CDOS where they may either be accessed and updated 
by user programs or may in turn be stored in 
registers of an electronic clock. No parameters 
are returned by this call. 


fs 
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The operating system makes no check for the 
correctness or plausibility of the incoming values. 
It is up to the user to supply this error checking. 
Note in the I/O Device Drivers that a dummy routine 
is supplied to Start Clock. This dummy routine is 
called by the operating system during the Set Time 
function; thus, users may substitute their own 
routine in the drivers to initialize a hardware 
clock. 


146 (92H) - READ TIME OF DAY 


This call is used to retrieve the time of day 
(sec/min/hr) stored in CDOS by system call 145. 
The seconds are returned in the A register, the 
minutes in the B register, and hours (24 hour time) 
in the C register. Note that the C register is 
changed by this call unlike most other system calls 
which preserve C. 


This is the function which should be used by a 
program to recover the last previously stored time 
from the operating system. Note that if Set Time 
has not yet been used, Read Time will return the 
values 06/00/00. 


The I/O Device Drivers contain a dummy routine to 
Read Clock. This dummy routine is called by CDOS 
during the Read Time system call. Thus, users may 
substitute their own routine in the drivers to read 
the time from a hardware clock and store it in the 
time registers also supplied in the drivers. 


158 (96H) - TURN DRIVE MOTORS OFF 


This call is used to turn off the disk drive 
motors. It may be used by any program which will 
perform its primary function in memory over a long 
period of time during which there will be few disk 
accesses (e.g., an editor or interpreter). No 
parameters are required on entry or given on return 
from this call other than the value in the C 
register. 


Note that there is no corollary call to turn the 
motors on. This will be performed automatically by 
the operating system the next time any disk 
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operation is attempted. CDOS will also pause for 
approximately 1 second after turning on the motors 
and before accessing the disk only if the Motor Off 
call has been issued. This is to allow the motors 
to come up to speed before the disk is accessed. 


151 (97H) - SET BOTTOM OF CDOS IN RAM 


This call is used to set the bottom address of CDOS 
to a lower value than the one at which CDOS was 
originally loaded when it was booted up. The high 
byte of the address of the new bottom is placed 
into the E register prior to executing the call. 
The low byte is assumed @; thus, the bottom of CDOS 
can never be located on any address other than a 
256 byte boundary. If the value is -1 (FFH) or any 
other value greater than the high byte of the 
original bottom when booting up, CDOS will restore 
this original bottom address. No parameters are 
returned by the call. 


This function will change the system call jump at 
locations 5, 6, and 7. Programs using the address 
at locations 6 and 7 to determine the size of the 
present User Area will find this area to be reduced 
in size. A second set of jumps (9 bytes) will be 
loaded at the new bottom of CDOS which points to 
the old bottom so that system calls will still 
execute correctly. Note that. CDOS is in no way 
relocated by this function and will reside in the 
same memory space as it did previously. The 
purpose of the call is to make it possible to 
attach a permanent patch space to CDOS for programs 
which are to become a permanent part of the 
operating system for as long as it resides in 
memory. The only way the patch space may be 
removed is by a second Set Bottom call. 
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5.1.5 


Summary of CDOS System Calls 


Following is a summary table listing all the system calls described in 


Chapter 5 along with their entry and return parameters. 


are listed in numerical order, 


The system 


loaded into the C register to achieve the desired function. 


NUMBER 


- & 


Oo CON HDU BW NH 


ee 
my fF & 


ray 
Ww 


14 


15 


16 


17 


18 


19 


29 


(OAH) 
(@BH) 
(@CH) 
(@DH) 
(®EH) 
(O@FH) 
(1@H) 
(11H) 
(1 2H) 
(13H) 


(14H) 


FUNCTION 


PROGRAM ABORT 
READ CONSOLE 
(with echo) 
WRITE CONSOLE 
READ READER 
WRITE PUNCH 
WRITE LIST 


GET I/O BYTE 
SET I/O BYTE 
PRINT BUFFERED 
LINE 

INPUT BUFFERED 
LINE 

TEST CONSOLE 
READY 

DESELECT 
CURRENT DISK 
RESET CDOS AND 
SELECT DRIVE A 


SELECT CURRENT — 


DISK 
OPEN DISK FILE 


CLOSE DISK FILE 


SEARCH DIRECTORY 


FOR FILENAME 
FIND NEXT ENTRY 
IN DIRECTORY 
DELETE FILE 


READ NEXT 
RECORD 


calls 


i.e., by order of the number which is 
ENTRY PARAMETERS RETURN PARAMETERS 
none none 
none A = character 
(parity bit reset) 
E = character none 
none A = character 
E = character none 
E = character none 
(not used presently - reserved for expansion) 
none A = I/O byte 
E = I/O byte none 
DE = buffer address none 
DE = buffer address none 
none A = -l (FFH) if ready 
A = @ if not ready 
none none 
none none 
E = disk drive no. none 
DE = FCB address A = directory block 
A = -1 (FFH) if not found 
DE = FCB address A = directory block 
A = -1 (FFH) if not found 
DE = FCB address A = directory block 
A = -1 (FFH) if not found 
DE = FCB address A = directory block 
A = -1 (FFH) if not found 
DE = FCB address A = number of entries 
deleted 
DE = FCB address A= 6 if OK - 
A= 1 if end of file 
A = 2 if tried to read 
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21 


22 


23 
24 
25 


26 
27 


128 


129 


138 


131 


132 


(15H) 


(16H) 


(17H) 
(18H) 
(19H) 


(1AH) 
(1BH) 


(89H) 
(81H) 


(82H) 


(83H) 


(8 4H) 


(85H) 
(86H) 
(87H) 
(88H) 
(89H) 


(8AH) 


WRITE NEXT 
RECORD 


CREATE FILE 


RENAME FILE 


GET DISK LOG-IN 
VECTOR 

CURRENT DISK 
SET DISK BUFFER 
DISK CLUSTER 
ALLOCATION MAP 


READ CONSOLE 
(with no echo) 
GET USER REGI- 
STER POINTER 
SET USER CTRL-C 
ABORT 


READ LOGICAL 
BLOCK 


WRITE LOGICAL 
BLOCK 


(not used presently 


FORMAT NAME 

TO FILE 

CONTROL BLOCK 
UPDATE 
DIRECTORY ENTRY 
LINK TO PROGRAM 


MULTIPLY 
INTEGERS | 
DIVIDE 

INTEGERS 


USER'S MANUAL 


DE = FCB address A= @ if OK 
A= 1 if entry error 
A = 2 if out of disk space 
A = -]l (FFH) iff out of 
directory space 
DE = FCB address A = directory block 
A = -1 (FFH) if out of 
directory space 
DE = FCB address A = number of entries 
renamed 
none A = those disks currently 
logged-in 
none A = disk drive number 
DE = buffer address none 
none BC = address of bitmap 
DE = number of clusters 
A = sectors/cluster 
none A = character 
none BC = pointer to user 
register pointers 
DE = address of “C none 
handler (@ to ( 
reset; -l to disable) 
DE = block number A = @ if OK 
B = drive number A= 1 if I/O error 
B top bit = 1 if A = 2 if illegal request 
interleaved A = 3 if illegal block 
DE = block number A= @ if OK 
B = drive number A= 1 if I/O error 
B top bit = lif A= 2 if illegal request 
interleaved A = 3 if illegal block 
- reserved for expansion) 
HL = address of HL = address of 
string terminator 
DE = FCB address DE = FCB address 
DE = FCB address none 
DE = FCB address A = -1 (FFH) if error; 
else execute at 19@H 
DE = factor 1 DE = product 
HL = factor 2 
HL = dividend HL = quotient 
DE = divisor DE = remainder 
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139 
146 
141 


142 


143 


144 


145 


146 


147 
148 
149 


158 
151 


(8BH) 
(8CH) 
(8DH) 


(8EH) 


(8FH) 


(98H) 


(91H) 


(92H) 


(93H) 
(94H) 
(95H) 


(96H) 
(97H) 


HOME DRIVE 

EJECT DISKETTE 
GET VERSION OF 
OPERATING SYSTEM 
SET SPECIAL 

CRT FUNCTION 


SET DATE 


READ DATE 


SET TIME OF DAY 


READ TIME OF DAY 


SET PROGRAM 
RETURN CODE 

SET FILE 
ATTRIBUTES 

READ DISK LABEL 
TURN MOTORS OFF 
SET BOTTOM OF 
CDOS IN RAM 


B = drive number none 
E = drive number none 
none B = version-number 
C = release-number 
D = column address/ none 
special function 
E = row address/@ 
B = day none 
D = month 
E = year-1986 
none A = day 
B = month 
C = year-1909 
B = seconds none 
D = minutes 
E = hours (24 hr. time) 
none A = seconds 
B = minutes 
C = hours (24 hr. time) 
E = return code A = previously set return 
for next program code 
DE = FCB address none 
B = new attributes 
none DE = FCB address 
none none 
E = high byte of none 


address of bottom 


of CDOS 
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CDOS-CP/M Compatibility 


The Cromemco Disk Operating System (CDOS)* is an 
original product designed and written in 289 
machine code by Cromemco, Inc. for its own line of 
microcomputers. However, due to the large number 
of programs currently available to run under the 
CP/M** operating system, CDOS was designed to be 
upwards CP/M-compatible. Cromemco is licensed by 
Digital Research, the originator of CP/M, for use 
of the CP/M data structures and user interface. 
This means that most programs written for CP/M 
(versions up to and including 1.3) will run without 
modification under CDOS. This also means that 
Programs written for CDOS will not generally run 
under CP/M. 


There are several advantages to end-users which 


result from this compatibility. First, users of 
Cromemco machines are able to draw on the large 
library of existing CP/M and CP/M compatible 
programs available on the market. Second, users 
familiar with CP/M can easily move up to CDOS 
taking advantage of the many additional features 
available with CDOS. 


The enhancements contained in CDOS but not CP/M are 
primarily visible in the system calls. CDOS has 
added a number of new system calls to allow the 
user even more flexible means of device and disk 
I/O. System calls are in all cases executed by 
first loading the C register with the number of the 


call. In the case of the non-CP/M calls, the 


parity bit of the 8-bit quantity in C is set to 
allow for a new range of 128. This is apparent in 
the Summary of CDOS System Calls, Section 5.1.5. 


* CDOS is a Trademark of Cromemco, Inc. 
Mountain View, California 


**CP/M is a Trademark of Digital Research, Inc. 
Pacific Grove, California 
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CDOS Memory Allocation 


CDOS resides in high memory. It reserves memory 
below 19@H for its own use. The user is left all 
memory from 19@H to the beginning of CDOS (see 
below). 


A program with the three-letter extension COM can 
be loaded and executed by typing the program name. 
The program must have its origin at 199H because 
that is where CDOS loads and executes it. (Note 
that when saving files that have been linked using 
the CROMEMCO Linker, they can be LINKed anywhere 
using the /P option. This is because LINK 
automatically puts the correct jump instruction at 
199H.) After it is loaded, the program can use any 
memory at all. Note however that if it alters the 
CDOS areas, it will have no way of communicating 
with the disk or returning to CDOS. (CDOS would 
have to be reloaded by resetting the computer.) 


When loaded, CDOS places a jump instruction at 
bytes @, 1 and 2. If a jump is made to location @, 
the CDOS warm start, control will be returned with 
the prompt for the current drive (e.g., A). 
Command lines may then be entered from the console 
keyboard. CDOS places another jump instruction at 
locations 5, 6 and 7. The normal way to make 
System requests of CDOS is to call location 5 
(refer to Section 5.1). The address stored at 
locations 6 and 7 is the address of the beginning 
of CDOS and thus marks the upper limit of user 
memory. 


The following address map describes the memory area 
from @ to @FFH. All addresses are in hex. 


B...2 CDOS re-entry 

3 I/O byte 

4 reserved 

Se eel system request call 
8...408 interrupt vectors 


49...5B reserved 

5C...6B default File Control Block 1 (FCB-1) 
6C...7B default File Control Block 2 (FCB-2) 
7C..e7F reserved 

80...FF default command-line buffer 


When a COM program is run by typing the program 
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name on the console, the default command-line 
buffer and default file control blocks are used as 
follows. FCB-1 will contain the first filename, if 
any, typed after the program name. FCB-2 will 
contain the second filename, if any. The default 
buffer will contain the entire command line 
following the program name. For example, if this 
command line is typed: 


PROG FILE1.Z89 FILE2.COM 


CDOS will place "FILE1Z8@"in FCB-1, "FILE2COM" in 
FCB-2, "FILE1.Z8@ FILE2.COM" in the command-line 
buffer, and load and execute PROG.COM at 190@H. 
Note that the second FCB starts before the end of 
the first FCB. Before using FCB-1l, FCB-2 should be 
moved. If it is not moved, part of FCB-2 will be 
destroyed. 


The command line which is placed in the default 
buffer can be used to send more than two filenames 
to a program, or to start execution of a program 
with various options specified. For the following 
command line: 


PROG FILE1.Z28@ FILE2.COM OPTION1 OPTION2 


the string of ASCII characters "FILE1.Z8@ FILE2.COM 
OPTION] OPTION2" will be stored beginning at 
location 81H. The byte at location 88H will 
contain the length of the string. The byte 
following the string will contain a null (90). 
PROG.COM can then look at the command line stored 
in the default buffer to determine which options 
were specified. 


When a program is loaded, the disk buffer is set to 
80H, which is the default command buffer. If the 
disk is then read to or written from, this buffer 
will be altered. The program must either reset the 
disk buffer to another area or move the command 
line before accessing the disk, if it is desired to 
save the command line. 


90 


OR 
‘i \ 


CROMEMCO DISK OPERATING SYSTEM USER'S MANUAL 
5 - Programmer's Guide 


Cluster, Track, and Sector Numbers 


For system housekeeping, CDOS divides diskettes 
into Clusters. A cluster stores 1924 (1K or 4@@H) 
bytes. A large disk contains 243 clusters in the 
file area. A small disk contains 83 clusters in 
the file area. On both large and small disks, the 
first two clusters are reserved for the directory. 
Clusters are numbered starting with zero. 


CDOS further subdivides each cluster into 8 
records, each containing 128 (8@H) bytes. Under 
CDOS, the disk is written to and read from in one 
record units. 


Although files are written and read by 128 byte 
(one record) units, one cluster can not be divided 
between files. Even if a file is only 17 bytes 
long, it will still be viewed by CDOS as occupying 
1K bytes. Unless the file is erased, or combined 
with another file, the unoccupied balance of the 
cluster will not be able to be accessed by CDOS for 
the use of another file. This is why the DIRectory 
command lists file sizes in 1K increments. 


A Track is a physically defined circular path which 


-is concentric with the hole in the center of the 


disk. It is defined by its distance from the 
center of the disk. With the read/write head of 
the disk drive located on a given track, data may 
be read from or written to that track. A large 
disk uses 77 tracks, the first two (numbered zero 
and one) being dedicated to the system (System 
Area). A small disk uses 4@ tracks, the first 
three (numbered zero, one, and two) being dedicated 
to the system (System Area). 


A Sector is a subdivision of a track. A track ona 
large disk is divided into 26 sectors while a small 
disk track is divided into 18 sectors. Sectors are 
numbered starting from number one and each sector 
holds one record or 128 (89H) bytes. 


The 4FDC Floppy Disk Controller accepts 
instructions using track and sector numbers. CDOS 
keeps track of files on the disk by means of 
cluster numbers. When it is necessary to access 
the disk, CDOS converts its cluster numbers into 
the 4FDC's track and sector numbers. 


The following tables will allow the user to perform 
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these conversions: 


1) small disk - convert track and sector numbers 
to cluster number 


2) large disk - convert track and sector numbers 
to cluster number 


3) small disk - convert cluster number to track 
and sector numbers 


'4) large disk - convert cluster number to track 
and sector numbers 
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MAPPING OF TRACKS/SECTORS TO CLUSTERS ~ LARGE DISKS 
ERD A ROE DIORS 


ae Sectors 
pe . : 


OURFAANA 


unraoanrry 
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MAPPING OF CLUSTERS TO TRACKS/SECTORS ~- LARGE DISKS 


Sectors Within Each Cluster 
Tk,Sc Tk,Sc Tk,Sc Tk,Sc Tk,Sc_ Tk,Sc Tk,Sc Tk,Sc 


@2,01 82,07 62,8D 62,13 82,19 62,05 62,08 82,11 


Olé @2,17 62,63 82,99 62,8F 62,15 62,62 82,08 92,0E 
B2 @2,14 92,1A 62,06 62,0C G2,12 62,18 62,04 62,0A 
83 ®2,10 62,16 63,01 83,87 63,8D 93,13 3,19 93,05 
04 03,08 63,11 63,17 63,93 63,09 @3,0F 63,15 63,82 
85 03,98 63,8E 93,14 93,1A 93,96 963,9C 3,12 963,18 
66 @3,04 83,8A 63,18 63,16 64,01 84,07 64,0D 94,13 
07 @4,19 04,05 64,98 64,11 684,17 64,93 94,09 94,0F 
68 @4,15 64,02 84,08 64,0E 94,14 94,1A 64,96 G4,0C 
a9 @4,12 64,18 64,04 64,08A 04,18 64,16 5,01 65,07 
OA @5,0D 85,13 65,19 65,05 65,0B 95,11 95,17 05,983 
8B @5,09 65,8F 65,15 65,92 95,08 @5,0E 65,14 @5,1A 
BC @5,96 95,9C 95,12 65,18 65,04 @5,0A 95,19 05,16 
gD @6,91 686,07 86,0D 66,13 86,19 66,85 86,2B 86,11 
BE @6,17 66,93 66,09 66,8F 96,15 686,82 @6,98 96,0E 
OF @6,14 66,1A 66,96 6,8C 96,12 96,18 6,04 96,0A 
C 10 06,18 66,16 67,01 67,67 G7,8D 87,13 67,19 87,85 
abe ®7,0B 67,11 67,17 67,03 87,09 67,6F 7,15 @7,@2 
u 12 07,68 67,8E 67,14 67,1A 87,096 87,0C 87,12 87,18 
s 13 97,04 87,8A 67,18 67,16 88,81 68,67 88,8@D 98,13 
t 
e 14 @8,19 98,05 68,08 98,11 98,17 98,93 08,89 98,0F 
r 15 98,15 68,02 8,08 68,9E 68,14 §8,1A 98,66 8,9C 
s 16 @8,12 68,18 98,04 98,0A 98,19 8,16 89,81 99,87 
17 99,0D 69,13 69,19 69,65 99,0B 99,11 69,17 69,83 
18 89,09 69,0F 69,15 89,82 99,98 09,0E 69,14 99,1A 
19 @9,06 89,0C 99,12 69,18 99,94 99,0A 69,18 09,16 
1A @A,01 9A,67 @BA,8D G6A,13 GA,19 GA,05 6A,0B BA,11 
1B @A,17 GA,83 GA,89 OA,BF @BA,15 BA,G2 BA,B8 OA,GE 
ic @A,14 G6A,1A GA,86 BA,9C GA,12 @A,18 G6A,G4 GA,BA 
1D @A,16 9A,16 6B,81 6B,87 @B,8D B,13 @B,19 9B,85 
1E ®B,@B 9B,11 9B,17 @B,83 @B,89 @B,OF @B,15 OB,82 
1F @B,98 9B,®0E §6B,14 @B,1A 9B,86 @B,8C B,12 @B,18 
20 @B,84 9B,OA 9B,18 @B,16 @C,81 @C,97 8C,oD 0C,13 
21 @C,19 6C,85 6C,8B 6C,11 6C,17 6C,93 8C,99 OC, OF 
22 @C,15 9C,02 GC,88 BC,GE OC,14 8C,1A 9C,86 8C,B8C 
23 @C,12 @C,18 6C,04 6C,GA OC,1B 8C,16 6D,#1 OD,97 
24 @D,@D 8D,13 6D,19 8D,65 @D,8B @D,1l1 9D,17 96D,83 
25 @D,99 OD,O@F 8D,15 6D,82 @D,88 8D,BE ®D,14 @D,1A 
26 @D,06 9D,8C 6D,12 9D,18 8D,84 GD,®A BD,19 @D,16 
27 ®E,01 G6E,67 BE,8D GE,13 GE,19 GE,@5 GE,@B 6E,11 
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Mapping of Clusters to Tracks/Sectors - Large Disks (cont.) 


Sectors within Each cluster 
Tk,Sc Tk,Sc Tk,Sc Tk,Sc Tk,Sc Tk,Sc Tk,Sc Tk,Sc 


HAO ctruneo HO 
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Mapping of Clusters to Tracks/Sectors - Large Disks (cont.) 


Sectors Within Each Cluster 
Tk,Sc Tk,Sc Tk,Sc Tk,Sc Tk,Sc Tk,Sc Tk,Sc Tk,Sc 


Yur Orne rdga 
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YAR OrNeorA 


Mapping of Clusters to Tracks/Sectors - Large Disks (cont.) 


a 


Tk,Sc 


> ectors 


Tk,Sc 


Within 


Tk,Sc 


Tk,Sc 


clus 
Tk,Sc 


ter 
Tk,Sc 


26,19 
27,0B 
27,88 
27,94 
28,19 


28,15 
28,12 
29,9D 
29,89 
29,86 


2A,01 
2A,17 
2A,14 
2A,19 
2B, 0B 


2B,98 
2B,04 
2C,19 
2C,15 
20,12 


2D,@D 
20,89 
2D,86 
2E,81 
2E,17 


2E,14 
2E,18 
2F,9B 
2F,98 
2F,04 


36,19 
38,15 
38,12 
31,6D 
31,89 


31,96 
32,61 
32,17 
32,14 
32,19 


26,16 
27,11 
27,8E 
27,@A 
28,685 


28,02 
28,18 
29,13 
29,0F 


-29,0C 


2A,07 
2A,03 
2A,1A 
2A,16 
2B,11 


2B,0E 
2B,9A 
2C,05 
2C, 82 
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2D,13 
2D, OF 
2D,9C 
2E,07 
2E,03 


2E,1A 
2E,16 
2F,11 
2F,GE 
2F,0A 


38,95 
39,02 
36,18 
S113 
31,0F 


31,0C 
32,07 
32,683 
32,1A 
32,16 


27,81 
27,17 
27,14 
27,19 
28,0B 


28,68 
28,04 
29,19 
29,15 
29,12 


2A,9D 
2A,89 
2A,96 
2B,81 
2B,17 


2B,14 
2B,16 
2C,@B 
2C,88 
2C,64 


2D,19 
2D,15 
2D,12 
2E,@D 
2E,99 


2E,86 
2F,@1 
2F,17 
2F,14 
2F,196 


38,8B 
38,088 
38,84 
31,19 
31,15 


a 
32,@D 
32,89 
32,86 
33,61 


(27,97 


27,93 
27,1A 
27,16 
28,11 


28,95 
28,0A 
29,85 
29,982 
29,18 


2A,13 
2A,0F 
2A,98C 
2B,97 
2B ,93 


2B,1A 
2B,16 
2c glk 
2C,@E 
2C,8A 


2D,05 
2D,62 
2D,18 
2E,13 
2E,@F 


2E,6C 
2F,07 
2F,03 
2F,1A 
2F,16 


38,11 
39,0E 
30,0A 
31,05 
31,82 


31,18 
32,13 
32,0F 
32,8C 
33,87 
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Each 
Tk,Sc Tk,Sc 
27,8D 27,13 
27,09 27,0F 
27,06 27,@C 
28,01 28,987 
28,17 28,83 
28,14 28,1A 
28,18 28,16 
29,8B 29,11 
29,08 29,05 
29,804 29,0A 
2A,19 2A,05 
2A,15 2A,@2 
2A,12 2A,18 
2B,9D 2B,13 
2B,89 2B,0F 
2B,8@6 2B,@C 
2C,@1 2C,8@7 
2C,17 2C,83 
2C,14 2C,1A 
2C,18 2C,16 
2D,@B 2D,11 
2D,08 2D,@E 
2D,@4 2D,@A 
2E,19 2E,05 
2E,15 2E,@2 
2E,12 2E,18 
2F,0D 2F,13 
2F,09 2F,@0F 
2F,@6 2F,0C 
38,01 30,87 
38,17 38,983 
39,14 360,1A 
39,19 38,16 
31,8B 31,11 
31,88 31,0E 
31,04 31,@0A 
32,19 32,85 
32,15 32,92 
32,12 32,18 
33,9D 33,13 


27,19 
27,15 
27,12 
28,4D 
28,09 


28,86 
29,01 
29,17 
29,14 
29,190 


2A,0B 
2A,908 
2A,94 
2B,19 
2B,15 


2B,12 
2C, 9D 
2C,89 
2C,86 
2D,91 


2D,17 
2D,14 
2D,19 
2E,@B 
2E,98 


2E,84 
2F,19 
2F,15 
2F,12 
390,98D 


30,89 
39,96 
31,01 
31,17 
31,14 


31,18 
32,0B 
32,98 
32,04 
33,19 


27,05 
27,82 
27,18 
265.413 
28,0F 


28,9C 
29,07 
29,83 
29,1A 
29,16 


2K 11 
2A,0E 
2A,0A 
2B,85 
2B,02 


2B,18 
2C,13 
2C,0F 
2C,@C 
2D,87 


2D,03 
2D,1A 
2D,16 
2E,11 
2E,@E 


2E,0A 
2F,05 
2F,02 
2F,18 
38,13 


38,0F 
39,8C 
31,87 
31,63 
31,1A 


31,16 
32,11 
32,05 
32,0A 
33,085 


Go 
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Mapping of Clusters to Tracks/Sectors ~ Large Disks (cont.) 


Sectors Within Each Cluster 
Tk,Sc Tk,Sce Tk,Sc Tk,Sc Tk,Sc Tk,Sc Tk,Sc Tk,Sc 


uN OoOrnGgceaA 
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Mapping of Clusters to Tracks/Sectors - Large Disks (cont.) 


Sectors Within Ea e-hy Co he St ee ae 
Tk,Sc Tk,Sc Tk,Sc Tk,Sc Tk,Sc_ Tk,Sc Tk,Sc Tk,Sc 


Or Orne rRaA 
iw) 
Q 


gros 


F2 4C,15 4C,82 4C,@8 4C,8E 4c,14 4C,1A 4C,06 4C,6C 
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MAPPING OF CLUSTERS TO TRACKS/SECTORS - SMALL DISKS 


Sectors Within Each cluster 
Tk,Sc Tk,Sc Tk,Sc Tk,Sc Tk,Sc Tk,Sc Tk,Sc Tk,Sc 


06 05,07 @5,8C 95,11 95,04 95,869 @5,8E 96,081 686,86 
07 86,9B 86,18 66,03 86,98 66,8D 86,12 66,85 86,0A 
88 96,0F 86,02 96,807 66,8C 96,11 86,04 86,89 86,8E 
09 7,91 67,86 87,08 67,19 67,83 87,88 67,8D 87,12 


OA 07,05 @7,0A 67,9F 67,82 87,87 @7,8C 67,11 87,04 
0B 07,09 97,8E 68,01 98,86 988,8B 88,18 98,83 98,88 


6C 08,8D 68,12 68,95 88,9A 88,8F 68,82 88,87 #8,8C 
OD 08,11 88,04 68,69 68,9E 69,01 99,06 99,8B 99,18 
OE 9,93 69,08 69,8D 89,12 99,05 69,8A 69,0F 99,62 


OF 09,07 99,0C 69,11 69,04 69,099 69,8E @A,8@1 GOA,86 
19 @A,9B @A,19 8A,03 GA,O8 BA,B8D BA,12 BA,O5 BA,BA 
ll OA,OF GOA,02 GA,87 BA,OC GBA,11 OA,84 BMA,B89 BA,BE 
12 @B,01 9B,86 9B,®B 9B,12 98,83 @B,0@8 8B,98D @B,12 
0B,95 6B,@A @B,OF @B,92 6B,87 @B,8@C 6B,1l @B,84 


14 B,99 8B,®8E 8C,81 8C,86 8C,8B OC,18 8C,83 GC,B8 


YUN Orne raN 
re 
Ww 


I5 8C,®@D 68C,12 6C,05 OC,9A OC,OF BC,82 BC,B7 BC,BC 
16 OC,11 98C,04 8C,09 GC,GE OD,G1 OD,86 O8D,8B B6D,18 
LT O8D,93 @D,@8 9D,9D 8D,12 6D,95 6D,0A OD,OF O8D,82 
18 O9D,07 6D,9C 6D,11 6D,84 6D,89 O8D,BE BE,#1 BE,B6 
19 @E,@B @E,10 9E,93 BE,88 GE,OD @E,12 GOE,85 BE,OA 
1A OE,@F @ME,02 BE,87 BE,8C GE,11 BE,84 GBE,89 BE,BE 
1B OF,91 OF,86 OF,9B OF,189 OF,93 OF,@8 OF,OD OF,12 
1c OF,05 OF,@A OF,OF OF,02 OF,O7 OF,GC OF,11 OF,04 
1D OF,89 OF,HE 18,01 18,896 18,08 18,18 19,83 18,68 
1E 19,@D 18,12 18,895 19,0A 19,0F 18,02 18,07 19,8C 
1F 10,11 18,04 18,89 18,8E 11,81 411,86 11,8B 11,18 
20 11,93 11,98 11,0D 11,12 11,85 11,0A 11,0F 11,62 
21 11,07 %11,8C 11,11 11,84 #%11,99 11,0E 12,01 12,086 
22 12,8B 12,18 12,83 12,098 12,0D 12,12 12,05 12,0A 
23 12,0F 12,02 12,87 12,8C 12,11 412,64 #%412,89 12,08 
24 13,81 13,86 13,8B 13,18 13,83 13,08 13,8D 13,12 
25 13,865 13,@A 13,08F 13,02 13,07 13,@C 13,11 13,64 
26 13,09 13,8E 14,01 14,06 14,0B 14,18 14,03 14,68 
27 14,0D 14,12 14,85 14,0A 14,0F 14,82 14,87 14,09C 
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Sectors Within Each cluster 
Tk,Sc Tk,Sce Tk,Sc Tk,Sc Tk,Sc Tk,Sc Tk,Sc Tk,Sc 


28 14,11 14,04 14,99 14,0E 15,01 15,96 .15,0B 15,19 
29 15,93 15,08 15,8D 15,12 15,05 15,0A 15,9F 15,82 
2A 15,07 15,8C 15,11 15,04 15,609 15,0E 16,61 16,86 
2B 16,9B 16,18 16,93 16,08 16,9D 16,12 16,85 16,@A 


2C 16,9F 16,02 16,87 16,8C 16,11 16,84 16,89 16,8E 


2D 17,01 17,06 17,868 17,18 17,83 417,88 %17,8D 17,12 


2E 17,05 17,0A 17,0F 17,02 17,87 #%17,80C 417,11 %417,64 

2F 17,99 17,8E 18,81 18,06 18,8B 18,18 18,83 18,88 

3@ 18,9D 18,12 18,85 18,0A 18,6F 18,82 18,87 18,6C 

31 18,11 18,84 18,89 18,8E 19,01 19,86 19,8B 19,198 

32 19,93 19,88 19,9D 19,12 19,85 19,@A 19,0F 19,982 

33 19,07 19,8C 19,11 19,94 19,809 19,8E 1A,01 1A,86 

34 1A,@B 1A,18 1A,@3 1A,88 1A,@D 1A,12 1A,85 1A,@A 

35 1A,6F 1A,62 1A,07 1A,®C 1A,11 1A,04 1A,89 1A,6E 

36 1B,61 1B,96 1B8,8B 1B,18 18,83 1B,88 1B,@D 1B,12 

a7 1B,@5 1B,@A 1B,@F (1B,82 1B,87 1B,8C 1B,11 1B,04 

38 1B,09 1B,8E 1C,81 1C,@6 1C,0B 1C,18 1C,83 1C,68 

39 127 OD. IC, 12 10,05: -1C,0A- 2C,0F 10,02 1C,07 -1C,0C 

C 3A 1C,11 1C,@4 1C,89 1C,8E 1D,@1 1D,86 1D,®@B =1D,19 

i. 238 1D,@3 1D,08 1D,®D 1D,12 1D,85 1D,@A 1D,8F 1D,62 
u 

s 3C 1D,87 1D,®C 1D,11 1D,04 1D,869 1D,0E I1E,91 1E,96 

t 3D 1E,9B 1E,18 1E,@3 1E,88 1E,@D 1E,12 18,85 1£E,9A 

e 3E 1E,@F 1E,@2 1E,87 1E,89C 1E,11 1E,04 1E,8@9 1E,@E 

r 3F 1F,@61 1F,86 1F,8B 1F,18 I1F,83 4I1F,08 %JIF,@D i1F,12 

s 48 1F,@5 1F,®A 1F,0F 1F,82 %1F,807 #.1F,®9C 41F,11 41F,04 

41 1F,809 I1F,8E 28,801 280,96 29,0B 280,180 280,893 28,88 

42 20,80D 28,12 280,05 280,0A 20,0F 28,02 28,87 28,0C 

43 28,11 20,04 20,09 28,9E 21,81 21,86 21,9B 21,19 

44 21,93 21,08 21,@D 21,12 21,05 21,0A 21,0F 21,62 


45 21,07 21,@C 21,11 21,04 21,99 21,8E 22,81 22,96 


46 22,0B 22,18 22,803 22,808 22,8D 22,12 22,05 22,8A 


47 22,0F 22,82 22,87 22,8C 22,11 22,84 22,89 22,05 
48 23,01. 23,06 23,0B 23,18 23,83 23,88 23,8D 23,12 
49 23,05 23,0A 23,0F 23,82 23,07 23,0C 23,11 23,04 


4A 23,09 23,0E 24,81 24,896 24,8B 24,18 24,83 24,88 


4B 24,8@D 24,12 24,805 24,9A 24,06F 24,82 24,87 24,@8C 
4C 24,11 24,04 24,09 24,8E 25,81 25,86 25,8B 25,18 
4D 25,803 25,08 25,8D 25,12 25,85 25,9A 25,0F 25,62 
45 25,807 25,@C 25,11 25,84 25,809 25,8E 26,81 26,86 
4F 26,8B 26,18 26,83 26,88 26,8D 26,12 26,05 26,0A 


5@ 26,0F 26,02 26,07 26,@C 26,11 26,04 26,89 26,8E 
51 27,801 27,86 27,8B 27,18 27,83 .27,88 27,®D 27,12 
52 | 27,05 27,0A 27,0F 27,02 27,097 27,8C 27,11 27,94 
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Error Messages 


In the event of a system malfunction, CDOS displays 
a complete error message to aid in the diagnosis 
and correction of the problem. The following 
section describes these messages and their 
interpretation, 


Disk Access Error Messages 


When the operating system cannot successfully 
access a disk an error message is displayed. 


Format: 


WRD Error, Drive X, Track YY, Sector ZZ, Status=HH 


where: 
WRD stands for one of the following 
words: 
Seek Error occurred in seeking a track on 
the disk. 
Read Error occurred during a read from 
the disk. 
Write Error occurred during a write to the 
disk. 
Init Error occurred during disk 
initialization. 
Xx is A, B, C, or D which represents 
the disk drive with the error. 
YY is the track number (in hexadecimal) 


where the error occurred. 
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6 - Error Messages 
ZZ is the sector number (in 
hexadecimal) where the error 
occurred. 
HH is the 8 bit status byte displayed 


in hexadecimal which describes the 
error and the conditions at the time 
the error occurred. 


The following table may be consulted for a detailed 
-analysis of the Status portion of an error message. 


Status 

Bits set 

(=1) Seek Read 

7 not ready not ready 

6 write protect* record type* 
5 head engaged* record type* 
4 seek error record not found 
3. cre error cre error 

2 track @* lost data 

1 index* data request* 
Q bus y* bus y* 
Status 

Bits set 

(=1) Write Init 

7 not ready not ready 

6 write protect write protect 
5 write fault write fault 

4 record not found not used* 

3 cre error not valid 

2 lost data lost data 

1 data request* data request* 
Q bus y* busy* 


The asterisk (*) in the above table indicates that 
the condition is not the cause of the error 
message, but that it was present when the error 
occurred. For example, if the status byte was 30H 
during a Seek error, this means that bits 4 and 5 
are set (=1). There is a Seek error and the head 
is engaged. The head is supposed to be engaged 
during a seek and therefore this condition is not 
an error and is marked with an asterisk. CRC 
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Stands for Cyclic Redundancy Check. This indicates 
that data was not transferred without error. 


There are four possible responses to the error 
message: 


R This will cause the system to retry 
the disk access which caused the 
error. Note: The error message 
does not appear until after the disk 
access instruction has been repeated 
ten times. 


I This will cause the system to Ignore 
the error message and continue. The 
function which caused the error 
message is not completed and no 
error code is returned to the 
calling program. 


Cc This will cause the system to 
' Continue. The function which caused 
the error message is not completed 
and an error code is returned to the 
calling program. 


CTRL-C This will abort the program and 
return control to the CDOS monitor. 


Examples: 


The following examples use some of the more common 
status codes: 


Seek Error, Drive A, Track 17, Sector 1A, Status=36 


During a Seek operation, status code 36 or B6 
indicates that the system expected to find a mini 
disk drive when there was actually a maxi drive (or 
vice versa) at the location (specified by A above). 
CDOSGEN may be run to correct this problem. Be 
Sure that the disk drives are correctly specified 
as small and large during the system generation. 


Read Error, Drive B, Track 1C, Sector 18, Status=19 
During a Read operation, status code 18 or 68 
indicate that the data is not readable. This may 


be caused by bringing the disk close to a magnetic 
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662 


source or by scratching or otherwise mishandling 
the disk. 


Write Error, Drive C, Track 3C, Sector 14, Status=49 


During a Write operation, status code 48 indicates 
that an attempt is being made to write on a write 
protected disk. The write protect sticker must be 
in place on a large disk and removed from a small 
disk in order to be able to write on the disk 


System Error Messages 

If an instruction is executed which causes control 

to be transferred to a nonexistent memory location 

or any-memory location containing @FFH (Restart 

38), the following imnessage will be displayed: 
Invalid jump to location xxxx. 


where: 


XXXX is the hexadecimal address to which 
control was transferred. 
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Glossary of Terms and Symbols 


i) 


Braces are used to indicate a choice of items. One 
of the items enclosed in the braces must be used in 
the position indicated. An optional choice of 
items is indicated by braces enclosed in square 
brackets. 


[ ] 


Square brackets are used to indicate an optional 
quantity. The item enclosed in square brackets may 
be used, in the position indicated, at the user's 
discretion. 


Ambiguous File Reference 


This is a File Reference which may refer to more 
than one file by using a Replacement Character(s). 
See section 1.3.2.2. 


Disk Specifier 


A Disk Specifier is one of the letters A, B, C, or 
D followed by a colon. This letter references a 
disk drive and allows the user to refer to a disk 
located in the drive. The Disk Specifier is an 
optional part of a File Reference. 
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Data File 


A File defines a group of related information. 
This information is addressed by means of a File 
Reference and usually resides on a floppy diskette. 


File Area (disk) 


User Files are stored on this part of the disk. 
The contents of this part of the disk are listed by 
the DIRectory command. See Section 1.2.1. 


File Name 


This is a one to eight character label which is 
used to refer to a File. Several Files may have 
the same File Name. These Files may be uniquely 
identified by the use of a Disk Specifier and/or a 
File Name Extension. A File Name is a necessary 
part of a File Reference. See section 1.3.2.1. 


File Name Extension 
This is a one to three character label which is 
frequently used to indicate how a file is to be 


used. A File Name Extension is an optional part of 
a File Reference. 


File-ref or 
File Reference 


A File Reference identifies and locates a File. 


Format: [x:]filename[.ext] 


where: 
X is an optional Disk Drive 
Specifier. 
filename is a File Name. 
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ext is an optional File Name Extension. 


A File Reference is a Single File Reference unless 
it is specifically stated that it may incorporate 
Replacement Characters to form an Ambiguous File 
Reference. See sections 1.3.2.1 and 1.3.2.2. 


Replacement Character 


A Replacement Character is an asterisk (*) or a 
question mark (?). These characters may be used 
where specifically indicated in order to create an 
Ambiguous File Reference. See section 1.3.2.2. 


Single File Reference 


This is a label specifying a unique File. This 
File Reference may not include Replacement 
Characters. See section 1.3.2.1. 


System Area (disk) 


CDOS is stored on this part of the disk. This 
section is normally accessed only by CDOS. It does 
not appear in the User Area DIRectory. See Section 
VeZe ls 


User Area (memory) 
The User Area is memory which is available to user 


programs. This is the part of memory from 188H up 
to the bottom of CDOS. Refer to section 1.1. 
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INDEX 


A 

Addresses, 27 

Ambiguous File Reference, 18, 187 
ATRIButes, 39 

Automatic Startup and Program Execution, 35 


B 

Batch (@) command, 48 
BYE, 41 

Cc 


CDOS, 7, 63, 88 

CDOSGEN, 7, 21 

Clock Switch, 39 

Close Disk File System Call, 73 
Clusters, 91 

Cold Bootstrap, 31 

Command Structure and Syntax, 36 
CONPROC, 198, 33, 36 

Control Character, 32, 33, 34 
CP/M Compatibility, 88 

Create File System Call, 75 
Cromemco 3355 Daisywheel Printer Driver, 38 
Current Disk System Call, 76 
Current Drive, 31l 


D 

Data File, 14, 108 

Default Drive, 31 

Delete File System Call, 74 
Deselect Current Disk System Call, 72 
Device Names, 15 

DIRectory, 42 

Disk, ll 

Disk Access Error Messages, 193 
Disk Cluster Allocation Map, 77 
Disk Drive Configuration, 22 

Disk File Reference, 16 

Disk Log-in Vector System Call, 76 
Disk Organization, 12 

Disk Precautions, 13 

Disk Specifier, 197 

Divide Integers System Call, 81 
Drive Selection, 31 

DUMP, 51 


E 
EDITor, 62 
Eject Disk System Call, 79 
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Index 


ERAsSe, 44 


F 

File, 14, 198 

File Area, 12, 108 

File Defined Function Key Decoding, 25 
File Name, 198 

File Name Extension, 198 

File Reference, 16, 18, 198 
File-ref, 1688 

Find Next Entry System Call, 74 
Floppy Diskettes, il 

Format Name to FCB System Call, 78 
Function Key Decoding, 23, 24, 25 


G 

Generating a New CDOS, 21 

Get I/O Byte System Call, 68 

Get User-register Pointer System Call, 8@ 
Get Version Number System Call, 81 
Glossary of Terms and Symbols, 187 


H 
High Memory, 9 
Home Drive System Call, 79 


I 

INITialize, 51 

Input Buffered Line System Call, 68 
Intrinsic Commands, 36, 39 


L 
Link to Program System Call, 81 
Low Memory, 9, 19 


M 

Memory Allocation, 9, 89 

Memory Size, 22 

MEMTEST, 59 © 

Modification - 16KZ Card, 39 
Motors Off System Call, 83 
Multiply Integers System Call, 81 


N ; 
No Function Key Decoding, 24 


O 
Open Disk File System Call, 73 
Output File, 26 
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P 

Powe 
Prec 
Prim 
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r-on Jump, 39 
autions Concerning Diskettes, 13 
ed Registers, 63 


Print Buffered Line System Call, 68 


Prog 


R 

Read 
Read 
Read 
Read 
Read 
Read 
Read 
RENa 
Rena 
Repl 


ram Abort System Call, 89 


Console (with echo) System Call, 65 


Console (without echo) System Call, 78 


Date System Call, 82 
Logical Block System Call, 77 
Next Record System Call, 75 
Reader System Call, 66 
Time System Call, 83 

me, 45 

me File System Call, 76 


acement Character, 18, 189 


Reset CDOS and Select Drive-A System Call, 73 


Rese 


S 

SAVE 
Sear 
Sect 
Sele 
Set 
Set 
Set 
Set 
Set 
Set 
Set 
Sing 
Stan 
STAR 


STATus, 
Switch 
Switch 
Symbol 
Symbol 


Syst 
Syst 
Syst 
Syst 
Syst 
Syst 
Syst 
Syst 


t Switch, 37 


, 46 

ch Directory System Call, 74 

or, 91 ; 

ct Disk Drive System Call, 73 

Bottom of CDOS System Call, 84 

Date System Call, 82 

Disk Buffer System Call, 76 

I/O Byte System Call, 68 

Special CRT Function System Call, 79 


‘Time System Call, 82 


User CTRL-C Abort System Call, 89 
le File Reference, 16, 199 
dard Function Key Decoding, 23 
TUP.CMD, 35 

a3 
Settings - 4FDC, 29 
Settings - ZPU, 39 

{[ ], 197 

{ }, 107 
Area, 12, 91, 199 
Calls, Detailed List, 
Calls, Disk, 72 
Calls, I/O Device, 65 
Calls, Introduction, 63 
Calls, Miscellaneous, 8@ 
Error Messages, 196 
Start-up, 29, 31 


em 
em 
em 
em 
em 
em 
em 
em 
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Introduction 


The Cromemco Disk Operating System (or CDOS) has 
now been completely rewritten, and a number of 
features have been added. This new operating 
system has been dubbed Series-2 CDOS, derived from 
its version numbers: 02.xXxX. Among its new 
capabilities are complete handling of Cromemco 
double-sided floppy drives and 11 Mbyte hard disks, 
an interface to the new Cromemco 3102 terminal, and 
a newly rewritten CDOSGEN. 


Cromemco System Three computers are now equipped 
with double-sided disk drives and 2Z-2H computers 
with both double-sided disk drives and a hard disk. 
These new computers require Series-2 CDOS for 


‘correct operation of these drives. 


To assure that you receive the latest revision of 
CDOS, machines which require Series-2 CDOS for 
correct operation are now shipped with a diskette 
containing the operating system. In addition, 
Series-2 CDOS is being added to all software 
packages, Should the CDOS supplied with a 
particular package be an older version (01.07), you 
will want to replace it with the Series-2 CDOS 
shipped with your computer. 


This manual describes some of the differences 
between Series-2 CDOS and older versions. In 
addition, it describes the procedures which must be 
followed to enable you to use double-sided 
diskettes and hard disks. The structures of the 
various types of disks themselves are described. 
Two of the utility programs have been rewritten and 
greatly expanded to support the new features of 
Series-2 CDOS, and these (STAT and INIT) are 
documented here as well. 


In general, a simple procedure is followed to 
create a disk (of any type) for use with Series-2 
CDOS: 


1. Initialize the disk (if required) using the INIT 
program. Generally, only blank single-sided 
floppies require initialization, 


2. Label the disk using the STAT program with the L 
option, 
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Any single-sided floppies you are currently using 
are completely compatible with Series-2 CDOS 

without change to them. The above procedure is 

Cora es in greater detail in the sections which 
Ollow. 
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Section iI-1 
Double-Sided and Hard Disk Drives 


II.1.1 Introduction 


II.1.2 


Before beginning to use double-sided and hard disks 
with Series-2 CDOS, it is important that you 
understand something about the structure of the 
disk(s) you will be initializing and labeling. The 
next sections describe the physical layout of 
floppy and hard disks. 


Recognizing Cromemco Floppy Diskettes 


All diskettes now supplied by Cromemco are tested 
and certified for double-sided, double-density use. 
You can recognize that this is true by noting that 
the disk lot-number (on back of the jacket in the 
lower left-hand corner) is followed by a "/2". You 
can also recognize a double-sided, double-density 
(DS-DD) diskette by its physical characteristics, 


Cromemco 5" DS-DD disks have a long head-slot 
(1.35" or 3.5cm.). Note that using the old style 
5" disks having the 1.18" (or 3.0cm.) slot with a 
DS-DD drive may ruin the drive, and that Cromemco 
considers this a non-warrantied misuse of 
equipment. 


Cromemco 8" DS-DD disks have two index holes. The 
most central of these should be exposed when using 
the disk as single-sided, and the hole slightly to 
the right (facing the disk) should be exposed when 
using the disk as double-sided. It is strongly 
recommended that either one or the other of the two 
index holes he covered using the di 
Cromemco supplies special labels made for this 
purpose. 


An additional point to note is that Cromemco 8" DS- 
DD disks are supplied already initialized for 
double-sided use by means of the double-sided index 
hole. Therefore, it is strongly recommended if you 
plan to use these disks as single-sided that (1) 
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you cover the double-sided index hole and (2) re- 
initialize the disk before adding any data to it. 
This will assure you compatibility with future 
Cromemco hardware products. 


Track & Sector Structure of Cromemco Floppy Disks 


This section describes the track and sector 
structure of CDOS floppy disks. CDOS single- 
density disks (both single-sided and double-sided) 
use a sector size of 128 bytes. 8" single-density 
CDOS disks have 26 sectors per track (numbered 1 
through 1AH) and have 77 tracks per disk-side 
(numbered 0 through 4CH). A cylinder is defined as 
one track through all surfaces. Therefore, an 8" 
disk has 77 cylinders per disk, which is the same 
as 77 tracks if it's single-sided and 77 * 2 = 154 
tracks if it's double-sided. This structure is 
identical to that of IBM 3740-format diskettes, 


5" single-density CDOS disks have 18 sectors per 
track (numbered 1 through 12H) and have 40 
cylinders per disk (numbered 0 through 27H). This 
means a 5" disk has 40 tracks if it's single-sided 
and 40 * 2 = 80 tracks if it's double-sided. 


The table below shows the track capacities and 


total disk capacities in kilobytes of the 
initialized floppy diskettes described above, 


Track <p SS-SD DS-SD 


2.25 2.25 
8" 3.25 3.25 
Total Cap. 
5" 90 180 
8" 250 500 


Cromemco numbers its cylinders (either side) in 
increasing order from the outer-most edge of the 
diskette, This follows IBM practice, and means 
that data is recorded and retrieved by CDOS in 
order of alternating sides beginning with Track 0 
(or Cylinder 0, Side 0). 


Since a side change operation is much faster than a 
seek to the next track (less than lms. for a side 


change vs. more than 6 ms. for a seek), this method 


of accessing data back and forth across the two 
sides as the head moves into the center of the disk 


is much faster than accessing all the data on one 


side of the disk followed by the data on the other 
4 


S 


II.1.4 


Series-2 CDOS Instruction Manual 


side, as is done by some operating systems other 
than CDOS. 


Track & Sector Structure of Cromemco Hard Disks 


CDOS hard disks use a sector size of 512 bytes. 
They have 20 sectors per track (numbered 0 through 
13H) and have 350 data cylinders per disk (numbered 
0 through 15DH). Each cylinder is composed of 
three tracks (one on each of surfaces 0,.1, and 2). 


The track capacity of the initialized hard disk 
just described is 10 Kbytes, and the total disk 
capacity for data is 10,500 Kbytes, or 10.5 Mbytes. 


In addition to the standard data tracks described 
above, a hard disk has 12 reserved tracks (on 4 
cylinders) for use as alternate tracks. Alternate 
tracks l through 12 correspond to physical 
locations on the drive: Cylinder 15EH, Surfaces 0, 
1, and 2; Cylinder 15FH, Surfaces 0, 1, and 2; 
Cylinder 160H, Surfaces 0, 1, and 2; and Cylinder 
161H, Surfaces 0, 1, and 2; respectively. 


Alternate tracks are used in place of standard data 
tracks, which may, over the life of the drive, 
develop hard errors. Any track on the hard disk 
may be assigned to any of the alternate tracks 
except Track 0 (or Cylinder 0, Surface 0) and the 
alternate tracks themselves (i.e., one alternate 
track can not be declared as an alternate to 
another). Track 0 can not be declared an alternate 
track itself because the second half of Sector 13H 
on Track 0 is used to store the Alternate Track 
Table, which is used by CDOS to determine which 
tracks on the disk have alternates. 


CDOS reads and stores in R/W memory the Alternate 
Track Table, and checks this before accessing any 
track to determine whether it need access an 
alternate instead. 


CDOS accesses data on the hard disk in a similar 
manner to the way it does on double-sided floppy 
diskettes: by accessing all surfaces of a cylinder 
in increasing order and then moving the head 
towards the center of the disk to access the next 
cylinder. This method provides for much faster 
data access times than reading all of one surface 
before going on to the next. 
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Although Cromemco hard disks use a sector size of 
512 bytes, this is entirely transparent to the user 
in the operation of CDOS, Programs which operate 
under CDOS will always consider the physical record 
size to be 128 bytes as they have in the past for 
floppy diskettes. This means that no changes are 
required to existing programs to enable them to run 
on the hard disk. CDOS takes care of translating 
the program-supplied 128-byte physical records into 
corresponding segments of 512-byte hard disk 
sectors, and of reading or writing these to the 
disk only when necessary. The maximum file size 
under the schema CDOS uses is 4 Mbytes and the 
maximum number of files per drive is 512. These 
points are discussed further in other sections of 
this manual, 


File Structure of CDOS Floppy and Hard Disks 


All types of CDOS disks are divided into two main 
sections: the system area and the file area. The 
system area is always 52 128-byte physical records 
(or exactly 6.5K), is recorded sequentially by 
sectors (non-interleaved), and is always recorded 
at the outer-most tracks of the disk. The first 
sector of the disk (also the first sector of the 
system area) contains a short boot program used by 
the RDOS monitor on the disk controller to load 
CDOS. 


The remainder of a particular disk is called the 
file area. This area may be of variable length 
(although fixed for that particular type of disk), 
is recorded with interleaved sectors, and contains 
both the files stored on that disk as well as the 
directory enabling CDOS to find then, The 
directory always begins with Sector 1 of a 
particular track, which is determined according to 
disk type by the table below. The entries in this 
table are listed as cylinder number, surface 
number. 


5" 3,0 2,71 
8" 2,0 1,0 
Hard 0,1 
File Cap. Including 
5" 83 173 
8" 243 494 
Hard 10490 
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As stated, Sector 1 of these tracks begins the 
directory and is the start of the sector 
interleaving for the disk. Interleaving factors 
are fixed for a particular type of disk, and were 


chosen for optimum access times for file reads and 


writes. The interleaving factor for SS-SD 8" 
floppy disks matches that of CP/M disks. 
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Section II-2 
Generating Disks for Use with Series-2 CDOS 


Introduction 


There are some significant internal differences 
between Series-2 CDOS and previously-released 
versions of CDOS, which will be described here, 
First, it should be noted that the Cromemco 
software supplied with this note and all Cromemco 
software in the near future will continue to be 
supplied on diskettes recorded as single-sided, 
Single-density (although the second side may have 
been initialized). [Note, however, that these and 
all blank diskettes purchased from Cromemco are 
tested and certified for double-sided, double- 


‘density use, Refer to section II.1.2 for more 


information about Cromemco diskettes. ] 


The 11 Mbyte hard disk supplied in your Z-2H or HDD 
must be properly initialized and labeled for CDOS 
to be able to access it correctly. This has been 
done by Cromemco prior to shipping your hard disk; 
therefore, Cromemco recommends that you not 
initialize your hard disk upon receiving it unless 
there is a particular reason for doing so. [Also, 
be sure to unlock the carriage of the hard disk 
aie power-on and before attempting to use the 
disk. 


For details on how to change the name, date, or 
number of directory entries of your hard disk, 
refer to the labeling (/L) portion of the STAT 
section. Your hard disk has been supplied with 512 
directory entries (the maximum value) as the 
default. 


The CDOS supplied on the small (5") diskette 
enclosed with your hard disk machine has been 
configured for three drives: drives A and B are 
expected to be double-sided small floppy drives, 
and drive C is the hard disk. (This "CDOS Disk" 
must be booted up in drive A. Note that it 
requires 64K of RAM to boot correctly.) 
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You may change the drive configuration using the 
supplied program CDOSGEN. Changing the 
specification of the hard disk to another logical 
drive than drive C does not require that you re- 
label the hard disk. The label is used by CDOS 
only to determine certain parameters for file 
access on that drive. (Refer to the section 
describing STAT for more information.) 


Using Series-2 CDOS with Double-Sided Drives 


The 4FDC and double-sided floppy-disk drives 
supplied with your system are capable of accessing 
double-sided diskettes. You will probably want to 
take advantage of this by labeling a blank diskette 
for double-sided use and transferring all the 
enclosed programs onto this disk. This is done by 
following the instructions below. [Note that large 
(8") disks supplied by Cromemco and having two 
index holes are already initialized on both sides. 
skip step 2 below.] 


1. Boot up with the "CDOS Disk" supplied with 
your machine in drive A and insert a blank 
disk into drive B. (The CDOS disk requires 
64K of RAM to boot correctly.) 


2- Initialize the disk in drive B for double- 
sided use by executing the program INIT. Be 
sure to answer correctly the questions the 
program asks. (This step may be skipped if 
you are using 8" disks supplied by Cromemco.) 


36 Label the disk as double-sided by typing the 

command line "Stat/L B:". Answer the four 

questions asked by STAT, and the label will 

then be written. (You may press the RETURN 

key in response to the questions to select the 

default values built into STAT.) fThis 

procedure labels the disk in drive B and 

completes its preparation for double-sided 

“use. For more information on labeling disks, 
refer to the section on STAT. 


4, At this point you may transfer all the 
programs on the single-sided disk in drive A 
to the newly-completed double-sided disk in 
drive B by typing the command line: Xfer/V 
B:=A:*.*. 
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5. It is very important to understand the 
difference between double-sided diskettes and 
double-sided drives. CDOS can access both 
single-sided and double-sided diskettes in 
double-sided drives. 


If you were to use a CDOS which had been set 
up by CDOSGEN to access si -si j 
only, and you then attempted to operate this 
CDOS with double-sided diskettes, an error 
would occur. This same CDOS is capable of 
accessing double-sided drives by treating them 
as single-sided (it will use only one of the 
heads of each drive). 


Thus, after performing steps 1 through 3 
above, you should execute CDOSGEN and, by 
answering the questions, tell it that you wish 
to create a CDOS which accesses double-sided 
diskettes. Then, answer the last two 
questions of CDOSGEN with "B:CDOS" and "B:", 
to write both an operating system and a boot 
loader capable of accessing double-sided 
diskettes to drive B, respectively. Finally, 
remove your newly-created double-sided 
diskette from B, replace it in A, and boot up. 
Executing STAT will verify to you that both 
sides are, in fact, being used. 


II.2.4 Additional Information 


The following additional information is provided 
for interested users: 


1. The program CDOSGEN is too big to be executed 
under a 32K CDOS. Execute it under a 48K or 
larger CDOS. 


26 The maximum number of directory entries 
(extents) allowed with this version of CDOS is 
512 (dec.) for floppies and hard disks. The 
first File Control Block (FCB) on the disk is 
permanently allocated to the disk label, so 
the effective maximum number of entries is 
S11. The default number of entries supplied 
by STAT is 64 for all types of floppy drives 
except double-sided 8", which have 128 as the 
default. The default number of entries for 
hard disks is the maximum, 512. 


36 The disk label just mentioned is used by CDOS 
to determine cluster size and maximum number 
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of entries, The label has been preset to the 
name "Userdisk" for floppies and "Harddisk" 
for hard disks by the program STAT/L. 
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Section II-3 
System Status Program Instructions 


System Status 


The program STAT is used to display and change a 
variety of parameters used by the operating system. 
Its simplest use is to provide a printout on the 
console which is a complete summary of all aspects 
of the computer system, This can be done by typing 
the word "Stat" on the console in response to the 
CDOS prompt and then pressing the RETURN key to 
commence execution. STAT responds with the 
following information, if it's applicable: 


TIME and DATE: Printed on heading line if 
previously stored in CDOS. 


SYSTEM MEMORY: Description of amount and 
configuration of machine memory. 


DEVICE CONFIGURATION: Description of device 
assignment, 


DISK MEMORY: Description of total, used, and 
available disk space (in kilobytes). 


DISK CONFIGURATION: Description of total, used, 
and available disk space (in directory 
entries). 


DRIVE: Description of the selected drive. 


DISKETTE: Description of floppy diskette mounted 
in the selected drive. 


The general format of the command line for STAT 
includes a way to request information on any of the 
disk drives of the system: 


Stat[/ol][/o2][/...] [d:] [parameters] 


where the oi represent one or more of the options 
described next, d: represents one of the disk drive 
specifiers (A-H), and parameters represents any of 
a number of other parameters which may be required 
by the options. If the drive specifier is omitted, 
STAT will default to the current drive. Also note 
that multiple options may be specified; e.g., 
"Stat/A/S" and "Stat/DTB" are both legal 
expressions. 


\ 
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II.3.2 A Option (alphabetical directory listing) 


II.3.3 


This option will produce an alphabetical directory 
of file names on the selected disk, along with the 
space allocated to each one and their system 
attributes. The format of the command is: 


Stat/A [d:][filename.ext] 


where d: represents a disk specifier (A-H) and 
filename.,ext represents any single or ambiguous 
file name on that disk. Normal system status 
information is not displayed with this option 
unless the S option is invoked simultaneously. 


B Option (brief system status) 


This option allows the user to obtain a quick 
summary of available disk and machine memory if the 
normal full system status report is not desired. 
Upon typing "Stat/B" to select this option, the 
user is prompted with a display similar to the 
following: 


User memory size 49 K 
Total disk space 243 K 
Disk space left 34 K 
Directory entries left 24 


II.3.4 D Option {set system date) 


This option allows the user to store the current 
date in CDOS. This date may then be accessed by 
system or user programs through the Read Date 
system call (no. 144). The appropriate values will 
be returned in the A, B, and C registers (see CDOS 
Instruction Manual) in binary. Upon typing 
"Stat/D" to request this option, the user is 
prompted with 


(mm/dd/yy) : 


and is expected to respond with the current month, 
date, and year. STAT will respond by printing the 
full date along with the day of the week, 
Subsequent executions of STAT will display the date 
on the header line if it has been previously set 
using the D option, 
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If CDOS is rebooted, the date stored is reset to 
00/00/00. The normal printing of system status 
information is suppressed when the D option is 
specified. Also note that the date option may be 
used in conjunction with the time option by typing 
"Stat/DT". 


Pressing the RETURN key only in response to the 
date prompt above leaves alone the stored values 
for date in CDOS. This can be used if the user 
requested to set the date by means of Stat/D and 
then found it had been set previously. 


L Option (set label) 


This option is used to label a disk. Disk labels 
are a feature of Series-2 CDOS, which both allows 
users to assign a name and a date to their disk, 
and enables CDOS to obtain certain important 
information about that disk for file access. All 
system disks (including hard disks) may be labeled 
using the L option at any time; however, it is 
generally best to label a disk when it is 
completely blank (no files or data have been 
stored). 


The label option is invoked by typing "Stat/L". 
Following the normal printout of system status, the 
user will be prompted for either three or four 
items of information which comprise the disk label: 
1) the disk name, 2) the date, 3) the number of 
directory entries, and optionally for floppies, 4) 
whether the disk is single-or double-sided. 


All of these questions are supplied with a default 
quantity printed in brackets, which the user may 
specify by pressing the RETURN key only. If the 
disk has been previously labeled, the defaults will 
be the values stored in the existing label on the 
disk. If the disk has no label, the defaults will 
be those supplied by the STAT program; e.g., 
"Harddisk" and "Userdisk" are the built-in default 
names for hard disks and floppy disks, 
respectively. If a user has previously specified a 
date using the D option and no date is currently 
stored on the disk, the default date will be the 
current date. 


The label option may be used to change the number 
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of directory entries of a particular disk. The 
default values are 64 entries for all floppies 
except double-sided 8" disks for which the default 
is 128, and 512 entries for a hard disk. It is 
frequently desirable to have more than 64 entries 
on a floppy disk if a large number of short files 
are being stored. There is, however, a trade-off: 
increasing the allowed number of entries above 64 
uses additional disk space for the directory. STAT 
will allow you to enter any value between 64 and 
512 for the number of directory entries, but it 
will round the entered quantity to the next lower 
number evenly divisible by 4 (thus, 67 would be 
rounded to 64). In general, to make most efficient 
use of the disk, the number you enter for directory 
entries should be a multiple of 32 times the 
cluster size. For example, hard disks have a 
cluster size of 2 Kbytes and thus should have 
n*(32*2) directory entries, where n=1,2,3,..+,8. 
You can determine the cluster size for a particular 
disk from the normal system status display under 
DISK CONFIGURATION. 


If adding or changing a label on a disk 
necessitates destroying a portion of the present 
disk directory, STAT will automatically ask whether 
or not it's OK to do so. Responding "N" to this 
question cancels the label request and no label is 
written, Responding "Y" to this question clears 
the present directory and writes the label. Be 
aware that this effectively creates a blank disk 
because, even though data may still be stored on 
the disk, there will be no way to retrieve that 
information once the directory is cleared. 


Some users may be interested in what is physically 
written to the disk when writing a label. For hard 
disks and floppies the label becomes the first 


entry of the disk. It has roughly the same format 


as a file FCB (see CDOS Instruction Manual), 
containing both the label name in bytes 2-9 and the 
cluster numbers allocated to the directory in bytes 
16-31. The first byte of the entry will be 81H, 
which indicates that this is a label. 


Be aware that since the label always occupies the 
first entry of a disk, a disk allowing a total of n 
directory entries will have only n-l entries 
available to files. It is also important to note 
that directory entries of a hard disk represent the 
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Space assigned to that file Ehrowah directory 
extensions which are transparent to the user. This 
means that the number of declared directory entries 
(minus one for the label) is the actual maximum 
number of files which may be stored on that hard 
disk. For floppy disks, however, each directory 
entry represents a maximum of 16 Kbytes of file 
space. This means that individual files which are 
allocated more than 16 Kbytes of disk space will be 
assigned another directory entry for each 
additional 16K used. 


For floppy disks only, there is a second part to 
the label which is written to the last 8 bytes of 


-the first sector on the disk (in double-sided 


drives this is cylinder 0, side 0, sector 1). 
These 8 bytes will be used by CDOS in conjunction 
with future products capable of handling double- 
sided and double-density disk drives. The format 
of these bytes is as follows: 


bytes 1,2: The ASCII characters "LG" for 
large or "SM" for small diskettes. 

bytes 3,4: The ASCII characters "SS" for 
single-sided or "DS" for double-sided 
diskettes, 

bytes 5,6: The ASCII characters "SD" for 
single-density or "DD" for double-density 
diskettes, 

bytes 7,8: Reserved for future expansion, 


If any of bytes 3 through 6 are missing from a 
diskette (for example, if all 8 bytes are E5H as on 
a new diskette), CDOS assumes single-sided and/or 
single-density. 


Finally, some programmers may find it useful to 
read and check the disk label from programs to 
determine whether or not the user has inserted the 
proper diskette. This may be done through the Read 
Disk Label system call (no. 149) with the DE 
register pointing to 9 bytes of free memory where 
the label name can be stored. The byte pointed to 
by DE should contain a 0 to read the label of the 
current disk, and 1-8 to read the label of drives 
A-H, respectively. 


The desired label name will be read into the 8 
bytes beginning with the memory location pointed to 
by DE+1. Disk labels, unlike filenames, may be 
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both upper and lower case so user programs checking 
for a particular label should typically translate 
all characters in the label name to upper case. A 
label name which is returned as all ASCII periods 
(2EH) indicates that that disk has not yet been 
logged-on. A label name which is returned as all 
ASCII spaces (20H) indicates that that disk does 
not have a label (single-sided, single-density 
floppy) . 


S Option (status printout at same time) 


The S option is used in conjunction with the date 
(D), time (T), or alphabetical directory (A) 
options to cause the normal system status display 
to be performed in addition to the function 
requested. 


Any of the options described in this section may be 


specified together; e.g., "Stat/A/S" and "Stat/DTS" 
are both legal expressions. 


T Option (set system time) 


‘This option is similar to the date option except 


that it allows the the user to enter the time. 
This will also be stored in CDOS, and may be used 
to set the time of a hardware clock device if the 
CDOS I/O Drivers have been appropriately changed, 
Users of Series-2 CDOS with 3102 terminals will 
find that the T option sets the internal clock of 
the terminal. This may be displayed at any time by 
pressing CTRL-1 to view the status line. 


The timé may be accessed by system or user programs 
through the Read Time system call (no. 146). The 
appropriate values will be returned in the A, B, 
and C registers (see CDOS Instruction Manual) in 
binary. Subsequent executions of STAT will display 
the time on the header line if it has been 
previously set using the T option, 


If CDOS is rebooted, the time stored is reset to 
00:00:00. The normal printing of system status 
information is suppressed when the T option is 
specified. Also note that the time option may be 
used in conjunction with the time option by typing 
"Stat/TD". 


Pressing the RETURN key only in response to the 
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time prompt printed by the T option leaves alone 
the stored values for time in CDOS. This can be 
used if the user requested to set the time by means 
of Stat/T and then found it had been set 
previously. : 
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Section II-4 
Initialize Program Instructions 


Introduction 


The program INIT is used to initialize (also called 
formatting) floppy diskettes and hard disks. This 
process records the track, sector, and surface 
information on the disk to enable the disk 
controller hardware to address and retrieve 
information, All types of disks require 
initialization at some point after they are 
manufactured; however, many floppies are supplied 
by Cromemco already initialized and containing 
data, and Cromemco hard disks are always 
initialized at the factory during testing. 
Therefore, INIT is a program which you may use 
infrequently or perhaps not at all. 


INIT is a very important program, however, for the 
cases which do require the initialization of a 
disk. Some of its uses are to initialize new, 
blank floppy diskettes, to correct soft errors ona 
floppy disk which has previously been used with a 
mis-aligned drive, and to declare alternate tracks 
on a hard disk. 


Before attempting to use INIT, it is important that 
you understand something about the structure of the 
disk(s) you will be initializing. Section II-1l 
describes the physical layout of floppy and hard 
disks. Be sure you read and understand that 
section before attempting to initialize disks. 


Initial: s Disk 


INIT is executed by typing its name in response to 
the CDOS prompt. Although execution of the program 
is largely self-explanatory, some additional 
information is provided. INIT requires a number of 
parameters which must be supplied by the user in 
response to questions the program asks. 


The first question asks which drive is to be 
initialized. INIT determines the allowable 
responses to this question from CDOS; therefore, it 
is important that CDOS has been GEN‘'ed correctly 
for the computer system it is currently operating. 
The user should supply the correct drive letter in 
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response to this question. 


The next two questions ask for the first and last 
cylinders to be initialized. Bracketed quantities 
following these questions are defaults for the 
first and last cylinders on the disk; therefore, if 
the entire disk is to be intialized, the RETURN key 
may be pressed twice here, INIT is also capable, 
however, of initializing any single track or any 
range of tracks, 


The following question asks for the surfaces to be 
initialized. This question also has a default for 
all the surfaces on that type of drive (press 
RETURN to select the default). INIT is capable of 
initializing any single surface as well. 


Following the termination of this question by the 
RETURN key, the program will begin intializing the 
appropriate disk according to your instructions. 
It is possible to abort the initialization in an 
emergency by pressing the ESCape key at this point. 


When initialization is finished and control has 
returned to CDOS, the disk may be labeled using the 
program STAT/L. 


Alternate Track Declaration for Hard Disks 


For hard disks only, the INIT program will not 
return to CDOS immediately following 
initialization. Instead, it will ask one or two 
further questions about alternate track 
declaration, The user should be familiar with 
section II.1.4 before attempting to answer these 
questions, 


These two questions ask (1) whether you wish to re- 
declare of the existing alternate tracks and (2) 
whether you wish to add any new alternate tracks to 
the table. The usual procedure is to answer no to 
both these questions. 


If you answer yes to either of these questions, you 
will be further prompted for the hard error track 
to be declared an alternate, These will 
automatically be assigned a number from 1 to 12 by 
the program. The program prohibits any illegal or 
unreasonable reasponses during this part, and also 
inhibits a control-C program abort. This is 
because the current alternate track declaration is 
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being held in memory and has not yet been written 
back to the disk. It is strongly recommended that 
you not reset your computer or otherwise prevent 
program. 


Alternate tracks which have been declared at the 
factory (discovered during testing) should under no 
circumstances be removed from the alternate track 
table. Doing so voids any warranties Cromemco 
makes for hard disk drives. Cromemco keeps a 
record of the alternate tracks declared for each 
drive shipped. 
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